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PREFACE 



This manual provides instructions for using the AEDIT-86 interactive text editor. 
AEDIT-86 can be run within several environments including Series III, Series IV, 
and iRMX operating system. Basic knowledge of your system (ISIS and RUN, iNDX 
or iRMX), is assumeid. Specific information on running AEDIT-86 on different 
systems is given in the appendixes. 

This manual is for both new wers and those who are already fanMliar with microcom- 
put<irs and text editors. 

TiM manual is organized in tM& jpiixts as follows: 

Part I provides the basic information a user needs to use the AEDIT-86 text editor. 
It includes a tutorial, edit command descriptions, and a description of the AEDIT-86 
inv(x;ation. 

• ! Chapter 1, "Introduction and Tutorial," defines the hardware and software 

necessary to run AEDIT-86, describes invoking j|»i; |Mlng the editor, and 

provides a brief tutorial session. 

Chapter 2, "The Editor Basics," describes concepts essential to using AEDIT-86 
and provides an in-depth description of the AEDIT-86 display. 

Chapter 3, "Editing Commands," describes editing commands. Commands art- 
ordered in the chapter by subjects and without forward references (as much as 
possible). AEDIT-86 commands not mentioned in this chapter are described in 
Part II. 

• , Chapter 4, "AEDIT-86 Invocation," describes the invocation command syntax 

and the invocation controls. 

Part II lists more advanced uses of AEDIT-86 and describes the AEDIT-86 string, 
numeric, local, and global variables, the macro-related Commands— Macro and 
Execute, and the CALC command. 

• Chapter 5, "Macro Commands," describes commands that allow you to create 
I and use macros. 

• Chapter 6, "AEDIT-86 Variiil^'' itm^m |he local and global AEDIT-86 

variables you can access. 

Chapter 7, "CALC Command," describes the CALC command and illustrates it 
with examples. Arithftetic and logical operations aifcjWiPBfted. 

Chapter 8, "Advanced AEDIT-86 Usage," demonstrates the open-ended approach 
of AEDIT-86. Macros that enable advanced functions like word processing are 
described in this chapter. The macro fife IJilRJL.MAC, that is supplied with 
AEDIT-86, is listed and discussed. 

Chapter 9, "Configuration Commands," describes and lists the configuration 
commands required to create m ABDff -fi eofligunrCicMi file. 

Appendix A, "AEDIT-86 Command Summary," lists AEDIT-86 commands and 

command formats, and provides a brief explanation of each command. 

Appendix B, "AEDIT-86 Error Messages," lists AEDIT-86 invocation, editing, 
CALC, and macro errof li^sft^SB, tter rpAable causes and how they affect the 
system. 

Appendix C, "Using AEDIT-86 on the Series III," describes the system- 
dependent usage of AfiBtIT-44 m a Bms$ III. 
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Appendix D, "Using AEDIT-86 on the Series IV," describes the system- 
dependent usage of AEDIT-86 on a Series IV. 

Appendix E, "Using AEDIT-86 on iRMX Based System," describw the system- 
dependent usage of AEDIT-86 on iRMX based systems. 

Appendix F, "Configuring AEDIT-86 for Other Terminals," describes how to 
configure AEDIT-86 for several terminals and provides tfested configurations for 
specific terminals. 

Appendix G, "A3CII Cod^ij," U^^^^^^l|^.$«Qdes with their hexadecimal values. 
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punctuation 
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Characters shown in uppercase must be entered in the order 
shown. You may enter the characters in .^^^^prnmH/s- or 

Italics indicate variable information, such as filename. 

Brackets indicate optional arguments or parameters. 

The vertical bar separates options within brackets. 

Ellipses indicate that the preceding argument or parameter 
a*y be repeated. 

Punctuation other than ellipses, braces, and brackets must be 
entered as shown. For example, the punctually .^OWQ io the 
following command must be entered: 

RUN ftEIIT.i« tPI iflftMri . SRC H A C R Q ( UO RDP . M A C ) 

In interactive examples, input lines and user responses are 
printed in white_ on black to differentiate them from system 

'ASflfgy brackets indicate a key configif^ fer a function, e.g., 
<HEX> or <ESC>. 
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PART I 



Part I includes Chapters 1 through 4. It gives a general overview of AEDIT-86 and 
describes the basics required to use AEDIT-86, including a tutorial. All AEDIT-86 
commands are described in Part I, most of them in depth. However, some are 
mentioned briefly here, then fully described m Part II. Read Part I in the order it is 
presented before going on to Part K. 

Chapter 1, "Introduction and Tutorial," introduces AEDIT-86 and gives a short 
tutorial. It describes activating the editor; entering, changing, deleting, and copying 
text; some function keys; the main and the OTHER flies; and exiting the editor. 

Chapter 2, "The Editor Basics," describes several basic AEDIT-86 features, includ- 
ing the keyboard, the cursor, the end-of-file marker, screen-mode editing, display and 
menu format, beep warning, lines and line terminators, printing and nonprinting 
characters, tags, repeat function, and AEDIT-86's three buffers. 

Chapter 3, "Editing Commands," describes AEDIT-86's editing modes, commands, 
and function keys. 

Chapter 4, "AEDIT Invocation," describes AESIf -Si Invocation and the controls 
FORWARDONLY, VIEWONLY. RECOVER, MACRO, MACROSIZE, and 
BATCH. 



CHAPTER 1 

immm^mm and tutorial 



1.1 Introduction 

AEDIT-86 is an interactive, screen-oriented text editor with menu style command 
prompts. AEDIT-86 can be run within several envtronniaits inclading Series III, 

Series IV and iRMX Operating System. Specific informatics oa running AEDIT-86 
on the different systems is given in the appendixes. AEDIT-^ Ipequires a minimum 
of 96 Kbytes of ftee RAM. Additional free RAM improves AEDIT-86's performance 
significantly. 

AEDIT-86 takes advantage of CRT capabilities to allow you to: 

• Display and scroll text on the screen 

• Move to any position in the text file or to any point on the screen 

• Rewrite text by typing new characters over oM oAes 

• Make insn^Efio^ and deletions easily 

• Use windowing to view two ifies or two portiofir^f the mtm file simultaneously 

To simplify text editing, AEDIT-86 also provides features that allow you to: 

• Find any string of characters 

• Substitute one string of characters for another string 

• Move or copy sections of text in a file or to another file 

• Create macros to execute several cwmaads at mm, thereby simplifying repeti- 
tive editing tasks 

• Use arithmetic functions 

• Edit two files simultaneously 

• Format text automatically 

• Justify paragraphs 

• View lines over 80 chanteters IcMig 

• \Jm hmie word processing operations 

la mm-a^ Tutorial 

This session is a short tutorial that illustrates the most basic AEDIT 86 commands. 
The following functions are covered: 

• Activating the editor 

• Entering 'tmt 

• Changing text 

• Deleting text 

• Copying text 

• Using the OTHER Command 

• Exiting the editor 

The purpose of this tutorial is to get you started, not to fully document AEDIT-86 
commands. Only a few of the most basic AEDIT-86 commands are printed in this 
tutorial. For more complete information on AEDIT-86 features, concepts and 
commands, read Chapters 1 through 4. 
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This manual makes no references to any particular operating ^stem; the appendixes 
give operating-system dependent information. 



1.2.1 Activating the Editor 

, t- lis- 

Specific invocation commands are given in the appendixes. 
In general, AEDIT-86 is activated by typing the following: 



AEDIT <RETURN> 



The editor displays the following prompt at the bottom of the screen: 

- ? ? - system-id AEDIT Vx.y Copyright yyyy Intel Corp. 

Again Block Calc Delete Execute Find -find --more-- 

The question marks (-??-) in front of the system-Id indicate that AEDIT-86 is 
"waiting" for your input. When AEDIT-86 is "busy," the question marks are replaced 
by two exclamation points (-!!-). system-id is a string identifying the operating system, 
x.y is the AEDIT-86 version number, and yyyy is the copyright year(s). The vertical 
bar (I) (initially in the upper left corner of the screen) marks the end of the file 
(EOF). Because the new file you just created has no text, the vertical bar appears at 
the top left corner of the display area. As you type text into the file, the vertical bar 
moves and continues to mark the end of the file. The cursor initially covers the EOF 
marker. (The term cursor refers to the position indicator. The way in which the cursor 
is displayed — solid, BOn-Wnking block, underline, etc. — ^is teftainal dependent.) 

When first invoked, AEDIT-86 is at main command level waiting for your input. The 
menu prompt line offers a selection of main commands or modes (XCHANGE and 
INSERT are considered modes). When invoked, several main commands offer 
subcommands. You must be at main command level to execute commands, except 
when using cursor movement commands and the delete keys. AEDIT-86 does not 
return automatically to main command level after executing some commands (e.g., 
FIND). To return to the ffltia mmmand level or to extt WIERT or XCHANGE 
modes, press < ESC > . 

Throughout the manual, main commands and modes are written in uppercase to 
distinguish them from subcommands, which are written in upper/lowercase; e.g., 
QUIT Exit. Function keys are ewdtescd in angle brackets; e.g., < ESC > , < HEX > . 

To specify a menu selection (i.e., command or mode), press the initial letter of the 
selection (e.g., B for BLOCK). 

The word —more— on the prompt line indicates that there are more commands or 
modes. Press < TAB > to display the next line of prompts. Pressing < TAB > to 
display additional prompts is a cyclic operation (i.e., after the last prompt line is 
displayed, the first is rewfkfei). 



1.2.2 Erflering, Changing, and Deleting Text 

Before typing text into the file, you must press I to enter INSERT mode. The word 
[insert] is displayed at the bottom of the screen, indicating that you are in INSERT 
mode. Type a word but misspell it. To correct the error, press < RUBOUT > . Each 
time you press < RUBOUT >, the cursor backs up one column and erases the 
character. When the errooeoos character(s) is eimed, t^^^ eorrect character(s). 
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The line you just typed- maj^be deleted character-by-character with the < RUBOUT > 
key or in its entirety with the key configured to < DELLI > , delete line (usually 
configured to < CTRL-Z > ). Delete the line. The file is now empty, and the EOF 
marker is back in the upper left-hand corner of the screen. The cursor, however, 
remains in the same position on the screen until the next command is given. 

Now type the following sentence. Enter the text exactly as shown — several words are 
deliberately misspelled. 



High-levell languages (Pacal in particular) more <RETURN> 
closely modal the human thought process than low-level<RE 
languaaes such as assembly 1 a n q u a q e . < R E T U R IH >^^^^^^^^^^^| 



The first word in the sentence, levell, is misspelled. To correct this error, use the 
cursor control keys to position the cursor "over" the erroneous /. The cursor is moved 
by the cursor control keys (arrows), in the diwrfiM! iniiertrt by the arrow. (There- 
fore, press the up arrow ( < UP > ) twice to move the cursor to the first line. Then 
press the left arrow < LEFT > followed by < HOME >— the < HOME > key is 
used in conjunction with the cursor control keys for fast cursor movement — to move 
the cursor to the first position in the line. Now press the right arrow < RIGHT > 
nine times to position the cursor "on" the first /.) Hien press the key configured to 
< DELCH > , delete character (usually configured to ^Cnntl-"F > ) to delete the 
extra /. 

The J in Pascal has been omitted. To correct this error, position the cursor on the c 
in Pascal and type s. Text ii]^mq^»^I% mmm % the right as the s is inserted. 

Press < ESC > to leave INl^ERT mode and return to main command level. 

The word model is misspelled modal. To correct the error, type X to enter 
XCHANGE lasie. 

The word [exchange} is display^ &t tlte t$ottoia of the screen, indicating that you are 
in XCHANGE nao#. Position the cursor "over" the a and type e. 

Press < ESC > t© leave XCHANGE mode and return to main command level. 

You have learned how to insert text, exchange text, and delete individual characters. 
Now type the following sentence exactly as shown. First, type I. Then, position the 
cursor below the lines you just typed. Move the cursor to the end of the line using 
the right arrow key ( < RIGHT > ) followed by < HOME > , then press < DOWN > 
twice and < RETURN > once. The cursor is now positioned at the end of the file 
and at the begiB«iflg of an empty line. Type the following lines exactly as shown: 



Thus , 


h i g h - 


level 


1 a n 


g u a 9 


e 


s a r 


e 


e a s 


i e r 


and 


f as te 


r 


to < R E T U R N > 


write 


than 


1 ow- 1 


e V e 1 


1 a n 


9 


u a g e 


5 , 


5 i 


nee 


one 


less 


1 e 


5 s < R E T U R N > 


trans: 


I a t i n 


step 


i 5 


r e q u 


i 


r e d 


f r 


m 


con 


c e p t 


to CO 


de 


. < R E T U R N >■ 



Press < ESC > to leave INSERT mode and return to main csommand level. 



Note that the word less is typed twice. To correct this error position the cursor on 
the / of the second less. Because it appears at the end of the line, it may be deleted 
with < DELR > . Press the key configured to < DELR > , delete right (usually confi- 
gured to < CTRL-A > ). The < DELR > command deletes all text to the right of the 
cursor. ' ' 

Suppose you wish to delete the phrase from concept to code from the text, leaving 
the period at the end of the sentence. To do this, you must "block" (i.e., delimit) this 
section from the rest of the text using the BLOCK command followed by the Delete 
subcommand. 
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First, position the cursor over the first character of the section. In this cas^pi^ want 
the period to close the sentence, so position the cursor on the space before the /in 
from. Then pr€^ • for BLOCK. The @ sign covers the space. Then position the 
cursor one character past the end of the section you wish to block; i.e., place the 
cursor on the period immediately after the e in code. When you pressed B for BLOCK, 
the menu displayed several alternative subcommands: Buffer, Delete, Find, -find, 
Junjfj^d Put. „ 

To delete the phrase, press D for Delete. 

The phrase is deleted from the text and the space is closed automatically. The result 
is as Hifeasw: 

High-level languages (Pascal in particular) more 
closely model the human thought proceis than low-level 
languages such as Assembly langua|j;. 
Thus, high-level lifnguages are eaii»i''«r# fi'tlsSr 
write than low-level languages, since one less 
translation step is required. 



For faster cursor movement, use the (-)FIND or JUMP command. In the example 
above, to move the cursor to the word human (assuming that the current cursor 
position is at the end of the file), press the hyphen (-). AEDIT-86 prompts for the 
name of the target strings Type human and press < ESC > . The cursor moves to the 
h in human. To'mdv^g w^rd in the ffle with the FIND cQinmand, press F, then type 
the "target string" followed by 4^C». Nate th^t <ESC> must hm^^med to 
terminate the -FIND command. 

To jump to the beginning or the ead «tf ths '^m, «»|if press J for JUMP foltosied by 
S for Start or E for End. 



1.24 Qppying Text ^ ^, , 

Use the BLOCK command to copy existing text. If you want to copy a section of text 
to another part of your file, delimit the text using the BLOCK command and press 
B to specify the Brtffer subcommand. The text is held temporarily in a buffer. Then, 
position the cursor where you want the text to appear and press G, the GET command. 
This command prompts for an input file. Pressing < RETURN > "gets" the contents 
of the buffer (where titesi^tai^M^ held temporarily) and placses it at the current 
cursor position. 

To move a section of text to another part of your file and delete it from its present 
position, delimit the text using the BLOCK command and press D to specify the 
Delete subcommand. The text is held temporarily in a buffer. Then, position the cursor 
where you want the text to appear and press G, the GET command. The command 
prompts for an input file. Press < RETURN > to place the buffer contents at the 
current cursor position. Note that copying or deleting a section of text is controlled 
by either the Buffer or Delete subcommand under the BLOCK command. 

To copy a section of text to another file, delimit the text using the BLOCK command 
and press P to specify the Put subcommand. The menu prompts for an output file. 
Type in the fdename and press < ESC > or < RETURN > . If the specified file 

already exists, the message "overwrite existing file? (y or [n])" is displayed. The file 
is copied only if you respond with y. If the specified file does not exist, it is created, 
and the t«it is ti ike specified file. 
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1.2.4 Using the OTHER Command 

AEDIT-86 has two distinct and equivalent files: the main file and the OTHER file. 
The OTHER file increases the power of AEDIT-86. allowing you to switch between 
two editing files. To enter the OTHER file, use the OTHER command. Press O to 
eater the OTHER file. Prm O a seecmcl tarn to return to the main file. The OTHER 
command ii fptif described in Chapter 3. 



1.2.5 Exiting the Editor 

To exit fr(an editor, press Q for QUIT. 

The foUowky fiwpt appears: 

- ? ? - n 1 n p u t f I 1 e 

Abort I nl t Mr 1 te 

Three alternative subcommands are available. A aborts the session; W saves the file 
(Init is described in Chapter 3). 

If you do not want to save the contents of this practice session, press A to abort the 

session. 

The folkwiftg^jprompt is displayed: 

all efaa n|C a lost? (y or [nl) 

Press y. The ^itor exits, and the file is not saved. Control returns to the operating 
system. 

If y<M wmt to ^ve this file, press W. The following prompt is displayed: 
Output f 1 1 c : 

Type in a filename (e.g., MYFILE) and press < RETURN > . The editor writes the 
spec^lid Me I0 i^e main storage device. 
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CHAPTER 2 
IME EDITOR BASICS 



The following editor basics are described in this chapter: 

• Keyboard 

• Cursor 

• End-of-file (EOF) marker 

• Screen-mode editing 

• AEDIT-86 display and menu format 

• B^p warning 

• Lines and line terminators 

• Printing and nonprinting characters 

• Tags 

• Repeat function (count) 

• Buffer 




2.1 Keyboard 

The keyboard is your interface with the editoir. It §s a typewriter style, electronic 

keyboard that supports the ASCII character set. 

Every keyboard character can be considered a command because every key causes 
something to happ^. Most Ireys ate sclf-cxi^flAttwy. Some, however, are configured 

to perform functions rather than enter characters. These keys are called function 
keys; their names are enclosed in angle brackets throughout this manual. 



ARROWS The four keys labeled with directional arrows are the cursor 

control keys < LEFT > , < RIGHT > , < UP > , and < DOWN > . 

CAPS LOCK The CAPS LOCK or TPWR key provides uppercase or lower- 
or case entry of alphabetic characters. This key functions with the 

TPWR alphabetic keys only. 

CONTROL The CONTROL ( < CTRL > ) key changes the function of some 

< CTRL > keys on the keyboard. (For example, to change the function of X, 

hold down the < CTRL » aad pess X). 

< ESC > The < ESC > (escape) key exits modes, terminates commands, 

and returns the editor to main command level. 

< HOME> The < HOME > key allows faster cursor movement. Press an 

arrow key follow^, by ^ HOME> te page backward or forward 
through a file or to njiffve rapidly to the beginning or end of a 
line. < HOME > || ai$@ ipei ^-enter the reedit mode for Une- 

edit prompts. 



< RETURN > The < REJ,U^N > km 'mmm ^>mmm- i® the beginning of the 
next line in INSERt and XCHANGE modes and at main 
command level. It also terminates line-edit prompt except for the 
search commands (-)FIND and (?)REPLACE. The carriage 
return/line feed character is displayed in text as a blank. 



2-1 



The Edh or Basics 



AEDIT-86 User's Gukle 



< RUBOUT > The RUBOUT key deletes the character to the left of the cursor 

at main command level or INSERT mode. In XCHANGE mode, 
< RUBOUT > replaces the new cham^ tm thf h^ ^i^mmt 
with the original character. 

< TAB > The TAB key rotates the menu prompt line to display the next 

Hnc of commands. In INSERT or XCHANGE modes, < TAB > 
inserts blanks to the next deflaed tab stop (the default is every 
fourth column). 



2.2 Cursor 

The cursor indicates the entry point for all information. The cursor may be displayed 
as a solid nonblinking btodEi SSlM iiDderline, as a s(#tlMyN% bto^'i(Slfc>. ji ap rofa g 
on your terminal. 

The term cursor refers both to the cursor displayed on the screen (the physical cursor) 
and to the current lite location (the character "under" the cursor, or logical cursor). 
The physical and logical cursor diverge only when the physical cursor leaves the text 
area for prompt lines (for example, to enter a search command) or when the < UP > 
or < DOWN > command moves the cursor to a screen location past the end of a line. 
When the cursor is located past the end of a line, all commands except the < UP > 
and < DOWN > conunands (including < TAB > or an illegal command) move the 
cursor back to the ead of tte More execution. 

The actual cursor position is the space between the character on which it appears and 
the character immediately to the left. Thus, for some commands (e.g., INSERT, 
BLOCK, < DELL > , < DELR > ), characters are inserted (or deleted) directly before 
the character under the physical cursor. Some commands (e.g., XCHANGE and 
< DELCH > ) operate on the character immediately to the right of the actual cursor 
position; other commands (e.g., < RUBOUT > ) operate on the character immedi- 
ately to the left of the actual cursor position. 



2.3 End-of-File Marker 

The end-of-file (EOF) marker is a vertical bar (I) that indicates the end of a file. If 
the end of a file is on the scre^jl^ EOF marker is displayed tinnied|i^^:)^p|ir'the 
last character of the file. 



2.4 Screen-Mode Editing 

AEDIT-86's greatest advantage is its ability to display and verify changes to the text 
as you make them. You can move through your file making changes, insertions, and 
deletions, verifying them as you go. You can examine a screenful of text, locatp the 
text you waiit to iehange, change it, and review the next screenful of text. A petftton 
of text i» always displayed on the sireM 



2.5 AEDIT-86 Pisplay/Menu Format 

AEDIT-86 requires a CRT terminal (or a CRT section) with at least a 5-line, 80- 
column display screen (columns are numbered from to 79). The cursor is the refer- 
ence point for ail operations, e.g., INSERT. FIND, DELETE, REPLACE. The screen 
is divided into the following three sections (listed from bottom up): 

• Prompt line ' ^ 

• Message line ' r ., 

• T^ «iea 
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Figure 2-1 shows the screen after Al©IT-f6 is called but before any text has been 
2.5. 1 The Prompt Line 

The prompt line is the bottom line of the display. (The first position of the prompt 
line is blank.) The prompt line chains informaticMi on the options of commands or 
subcommands that you may perform. The three types of prompts are 

• Menu prompts 

• Line-edited prompts 

• Yes/no prompts 

The Menu Proinpt 

When AEDIT-86 is first invoked, the editor is at main command level and the menu 
prompt is displayed. Menu prompts are a partial list of up to eight words indicating 
available commands. The word -more— indicates that pressing < TAB > displays 
the next line of prompts. The < TAB > command is cyclic (Le., after the last prompt 
line is displayed the first ^«Bdisplayed). Figure 2-2 showt^w foot fffompl Unes 
availnble flinaiii ©Mmand level. 

To select the desired command, type the first character of the prompt word (indicated 
as an uppercase letter). The prompt for a command does not have to be visible to 
invoke it^ — it may be on one ^ fie pNMpt Uo0S indicated by -more-. The prompt 
line goes blank at the beponiog of the commaiMl^^^Uoo and is restored at the end. 




Figwe2-1. AEDIT-86 IKspiay i2i7S6-i 
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Figure 2-2. Menu Prompt Lines 121756-2 



The Line-Edited Prompt 

Line-edited prompts ask for information (such as a filename) that requires more than 
a single-character user response. The response can be up to 60 characters. It is termi- 
nated and the information sent by pressing < ESC > . In most cases < RETURN > 
may also be used to terminate a command. However, the search commands, (-)FIND 
and (?)R1PLACE, W8» fee »rfflinated with the < ESC > key. 

The first time a command is requested, the prompt line is empty and you simply enter 
the required informttM. 

If the command (or a related command) has been requested previously, the prompt 
line contains the information entered at that time. This iaforaiation may be reentered 
or edited, or new information may be entered. 

If you want to use the previously entered information with no ehanges; e.g., to repeat 
a FIND, press < ESC % mi ^is information will be recsBij^ed, } ■ 

To edit the previously entered information, press < HOME > to enter reedit mode. 

The cursor may now be moved to the position you want to edit, e.g., to correct a 
typing error in a target-string. The delete key commands ( < DELCH > , < DELLl > , 
< DELL > , < DELR > , <RUBOUT>), and cursor movement commands 
( < LEFT > , < RIGHT > , < HOME > ) are legal line-edit commands. After enter- 
ing the changes, press < ESC > to terminate line-edited input and send the entire 
string or press < RETURN > to terminate the string at the cursor. (The < ESC > 
key must be used for the search commands, (-)FIND and (?)REPLACE.) The 
characters to th& WNrf the cursor are sent, those to the right of the cursor are lost. 
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If you want to enter new information, simply type it in. As soon as any key is pressed 
(except for < LEFT > , < RIGHT > , < HOME > , or < ESC > ), the prompt line is 
blanked and the new characters are entered. Press < ESC > or < RETURN > to 
finish, the comnjand and send the information. 

To enter a character using its ASCII value in the line-edit prompt, simply type 
< HEX > (usually configured as < CTRL-H > ) followed by two hexadecimal digits. 
For example, < HEX > 41 enters m A. This option allows you to enter control 
characters (e.g., < ESC > ) into the text. 

The Yes/No Prompt 

The yes/no prompt form is "prompt ? (y or [n])", where square brackets surround 
the default, m » the following example: 

all e h a ii |,i $ 1 o at? C y o r C n ] > 

In this case, n is the default; therefore, tny response other fen y (or Y) is considered 
a negative response. (In a yes/no prompt where y is the default, any response other 
than n (or A') is considered a positive response.) 

2.5.2 Message Line 

The message line is directly above the prompt line. It is used to display status messages 
or to indicate the command mode. 

The busy/waiting indicator is disi^ay^i*®«?'fti6i rte^^ iftf.'For W3<nn4anis that take 
a relatively long time to execute, the busy/waiting indicator tells you if AEDIT-86 is 
still processing the command, or if it is ready to receive new input. This indicator is 
a configurable feature (described in Chapter 9). The to^/ww.tmg indicator may be 
displayed as one of the following: 

• -??- — indicates that the feature is on and AEDIT-86 expects input. 

• -!!- — indicates that the feature is on and AEDIT-86 is executing a command. 

• — indicates that the feature has been turned off with an AEDIT-86 config- 

uration command or that the feature is on, but the message line is for 
the nonactive window. 

If the busy/waiting indicator feature is on, -??- is displayed whenever AEDIT-86 is 
waiting for input. The expected input may be a command, a subcommand, a yes/no 
answer, an operand, etc. Also, whenever AEDIT-86 is processing a command, -!!- is 
displayed. If the busy /waiting iMwMor feature is off, — is displayed at all times. 
Later m iut itm manual the busy /waiting indicator is displayed as four dashes. 

If, for example, you type JS for JUMP Start, and the indicator is on, it is changed 
to -!!- as soon as AEDIT-86 accepts the command. The -!!- remains until AEDIT-86 
completes the command execution. The in^ator is then changed back to -11-. 

Next, one of the, following status words may be displayed: 

• Macro — iiB#eates that a macro is being defined. 

• Other ^ indicates that the OTHER file is being ^ited. 

• View — indicates that the VIEWONLY control is in effect. 

• Forward — indicates that the FORWARDONLY control is in effect. 

This part of the message line does not change unless the OTHER, MACRO, or editing 
mode of the file is changed. Other messages displayed on the message line are status 
messages, count (repeat function), and the line-edit prompt " < HOME > to re-edit". 
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AEDIT-86 does not write past the last column of the message line. If a message does 
not fit, ! is printed as the last character. 

When the message line contains status information, usually an error message, the 
message line goes blank as soon as any key is pressed. 



2.5.3 Text Area ' 

The rest of the screen is the text area. 

4« i!^ 



2.6 Beep Warning 

The editm beep wJtaM te^o something illegal, for exaiftgil:'* ' ^ 

• AtteipptiE^ l© Mtecute an illegal command _ 5,, 

• Typing an invalid character during INSERT or XCHANGE mode 

• Typing more than 60 characters in a line-edited prompt 

• Entering a repeat count greater than the maximum value 

3 "«' i r,t : 

It also b^p -'mkm ptnaiMti^ ^me of the error messages. 

■ .1 ."• ij, i ■ • ■ .i ll . Jill 

2.7 Lines s^ttie Termfnators 

A line of text consists of a sequence of characters terminated by a carriage return/ 
line feed. This pair of characters, called the line terminator, is entered in the file 
when you press < RETURN > . (RETURN is displayed on the screen as a blank.) 

If a line is over 80 characters long, an exclamation point (!) is displayed in the last 
column on the screen. The portion of the line that does not fit on the screen is not 
displayed. To view the portion that is not displayed, use the SET Leftcol command 
(described in Chapter 3). 

A line may contain any number of characters. AEPIT-86 breaks lines longer than 
255 characters into 255-character segments. A plus sign ( + ) is displayed at the end 
of each segment. 



2.8 Printing and Nonprinting Characters 

In general, all characters except those with ASCII values under 20H and characters 
with hexadecimal values equal to or above 7FH are displayed on the screen. All 
characters that are not displayed on the screen print as a question mark (?). Carriage 
return and tab print as blanks. If the Highbit feature (described in Chapter 3) is set, 
characters with bexadledii#'itf|Qil'tM' 7FH are di~^^^i';<ii^j ' 



2.9 Tags 

Tags identify locations in a file. You can specify four locations, A through D, with 
the TAG command and use them as destinations for the JUMP command. Tags are 
invisible *Bd at|> Ml MiWti when yoi* exit the fie. 1. . , • 
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2.10 Repeat Function (Count) 

Count is displayed on the message line and indicates the number of times to repeat a 
command. Some commands ignore count or, like delete character < DELCH > , limit 
count. Enter count before typing a command letter. It is then displayed at the left 
side of the message line. < RUBOUT > can be used to delete the value being entered 
for count. The cursor position after a command has been executed count times is its 
location when count is exhausted or no more occurrences are found. When the message 
line contains a count, the count is blanked when the next prompt is issued. The repeat 
count is an optional decimal repetition factor in the range to 65535 (2**16-1). Any 
attempt to type a larger value for count causes AEDIT-86 to beep. A forward slash 
(/) is asei^lei as a count and means repeat forever. The default count is one. 



2.11 Buftor 

AEDIT-86 has three buffers: the main buffer, the OTHER buffer, and the Block 
buff(^. jyi^nee buffiers are allocated space in the user's free RAM. 

The nia&l Iwffisr Is ih& text area itt startvf . It always contains a portion of the main 
file. 

The OTHER buffer is accessed with the OTHER command and always contains a 
portion of the OTHER file (if one exists). 

The buffer that is accessed and active is referred to as the "current" buffer; the one 
that is not being edited, as the "secondary" buffer. For example, if you are editing a 
file in the OTHER buffer, it would be referred to as the current buffer, and the main 
buffer would be referred to as the secondary buffer. 

If either the main or OTHER buffer is too small for the text file, AEDIT-86 extends 
the buffer with additional free RAM if it is available. When all free RAM is 
exhausted, AEDIT-86 writes to temporary files, usually on disk or diskette. AEDIT- 
86's performance improves with the amount of free RAM available. 

The Block buffer is the storage area for text that you move, copy, or delete, using the 
BLOCK/DELETE commands. The Block buffer allows you to move text between 
the main and the OTHER file. The Block buffer has a fixed size of 2 Kbytes. If more 
than 2 Kbytes is required, AEDIT-86 uses a temporary file. 
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This chapter describes all AEDlT-86 commands. Most of the commands are described 
in depth. However, s<Mne coiamands are only mentioned here and fully described in 
Part 11. 

■ '.'.1 fc» . '.r 



3.1 Cursor Mpvement Commands 

The cursor movement commands control cursor movement in a file. <LEFT>, 

< RIGHT > , < UP > , and < DOWN > XftfmM kgp labeled with directional arrows; 

< HOME > refers to the key labeM < HOME > (or eonfigured for this function). 



3.1.1 <LEFT> 

The LEFT command moves the cursor one character to the left. 
Special cases of < LEFT > are — 

• If the cursor is on the first character of the file, the command is ignored. 

• If the cursor is at the top of the screen and at the beginning of the line, the screen 
is rewritten/scrolled to display previous Iine(s) of text (the number of lines scrolled 
is terminal dependent). 

• If the cursor is at the lieginning of a line, the cursor moves to the last character 
of the previous line. 

• If the cursor is moving to a tab, < LEFT > skips over the tab. 

Count. This command accepts any count where count multiplies the distance moved. 
If count is / or greater than the number of characters that exist from the beginning 
of the file to the current cursor position, the cursor jumps t© the beginning of the file. 
The result of a repeated move is not displayed until the move is complete. 

Related CmmmSS' <HOME> 

3.1.2 <RIGm'> 

The RIGHT command moves the cursor one character to the right. 
Special cases of < RIGHT > are- 

• If the cursor is on the EOF marker, the command is ignored. 

• If the cursor is on the last charaetef of the last text line on the screen, the screen 
scrolls up (usually one line). 

• If the cursor is on the last character of a line, it moves to the beginning of the 
next lia#. ' 

• If tMiSUfMbf is movmg to a tab, <|KJS{lTt over the tab. 

CoDnt . This commatld accepts any cotfnl where oount multiplies the distance moved. 

If count is / or greater than the number of characters that exist in the file from the 
current cursor position to the end of the file, the cursor jumps to the end of the file. 
The result of a repeated move is not displayed until the move is complete. 

Related Commands . < HOME > 




3-1 



Editing OnmHuids 



AEDIT-86 User's Guide 



3.1.3 <:iP>M'i 

The UP command moves the cursor up one line in the same column. 
Special cases of < UP > are — 

• If the cursor is in the top line of the file, the command is ignored. 

• If the cursor is in the top line of the screen, the screen is rewritten/scrolled to 
display previous lin^| a! tBxt. The cursor remains in the same column as before 
the command. 

Count. This command accepts any count where count multiplies the distance moved. 
If count is / or greater than the number of lines that exist from the beginning of the 
file to the current cursor position, the cursor jumps to the first line of the file. The 
result of a repeated move is not displayed until the move is complete. 

Related Cmnmands. < MMf l> 



3.1.4 <[K>WN> 

The DOWN command moves the cursor down one line in the same column. 
Special cases of < DOWN > are — 

• If the cursor is on the bottom line of the file, the command is ignored. 

• If the cursor is in the last line of text on the screen, the screen scrolls up. The 
cursor ^ ^^p^^g^ as before the command. 

Count . This command accepts any count where count multiplies the distance moved. 
If count is / or greater than the number of lines that exist in the file from the current 
cursor position to the end of the file, the cursor jumps to the last line of the file. The 
result of a repeated move is not displayed until the move is complete. 

Related Commands . < HOM E > 



3.1.5 <HOME> 

The HOME command has two functions. 

1. Quick cursor movements. < HOME > allows you to page forward or backward 
through a file or jump to the end or beginning of a line, depending on the previous 

cursor movement command. 

• If < DOWN > was the previous command, the next page of text is displayed, 
leaving the cursor in the same column as at the start of the command. (You 
need to press < DOWN > only once for multiple paging; e.g., < DOWN > 
<HOME> <HOME> <HOME> pages three times.) 

• If < UP > was the previous command, the previous page of text is displayed, 
leaving the cursor in the same line as at the start of the command. (You 
need to i^hdss '<< UP > only once for multiple paging.) 

• If < LEFT > was the previous command, the cursor moves to the beginnkg 

of the line 

• If < RIGHT > was the previous command, the cursor moves to the end of 
the line. ■ " ' ' 

2. Line edit prompts to enter reedit mode. 
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Count . Count is significant only for < UP > and < DOWN > < HOME > s, where 
it multiplies the distance moved. 

Related Conmuuids. < LEFT* , < RIGHT > , < UP > , < DOWN > 

3.2 ^JmnAGE RETURN Cominancl 

The < RETURN > key moves the cursor to the beginning of the next line. Special 
£1^8 of < RETURN > are— 

• If the cursor is on the last line of the file, < RETURN > moves the cursor to the 
end of the file. 

• If the auto indent option (SET Indent) is on, < RETURN > moves the cursor 

to the first nonblank character of the next line. 

• If the cursor is on the last line of text on the screen, the screen scrolls up one 

Count . This command accepts any count where count multiplies the distance moved. 

If count is / or greater than the number of lines that exist in the file from the current 
cursor position to the end of the file, the cursor jumps to the end of the file. 

Related Cominands. SET Indent 



3.3 <CTRL-C> Function Key 

< CTRL-C > serves as & soft command abort. A < CTRL-C > is recognized as soon 
as it is typed, even if a command is in progress. Therefore, < CTRL-C > may be 
used to terminate a time-consumiog eomttknd while it is executing, e.g., a long FIND 
or repeated long macros. The tenni^^on is carried out at the first opportunity that 
allows termination without affecting AEDIT-86's integrity. < CTRL-C > does not 
abort the execution of an I/O related command. lOlis option is the only way to abort 
an infinite loop in macro execution gracefully. 



3.4 TAB Function Key 

Pressing the TAB key causes the next prompt line to be displayed. The prompt line 
display is cyclic (i.e., after the last prompt Une is displayed, the first is redisplayed). 

3.5 Delete Function Keys 

< RUBOUT > is a specifically labeled key. The other delete function keys are 
configurable: delete character < DELCH > , delete left < DELL > , delete right 

< » , mA delete line < DELLI > . 



3.5.1 <miiOUT> 

The RUBOUT key deletes the preceding character. If a line feed is deleted, the 
preceding carriage return is deleted also. 

There is no T<iam.<esy from titis i^lefiM. 

CMMt. « RUBOUT > ignores count. 
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3.5.2 <DELCH> 

The DELETE CHARACTER command is configurable, usually as < CTRL-F > . It 
deletes the character "under" the cursor. If a carriage return is deleted, the following 
line feed (if any) is also deleted because in this case, AEDIT-86 considers the carriage 
return/line feed pair as a single character. 

There is no recovery from this deletion. 

Count . This command limits count to 32 to prevent accidental destruction of the file. 
If count is greater than 32, the message "cannot delete more than 32" is displayed 
on the message line. 

3.5.3 <DELL> 

The DELETE LEFT command is configurable, usually as < CTRL-X > . It deletes 
all characters to the left of the cursor on the line on which the cursor is positioned. 

The deletion can be recovered with the < UNDO > command. 

Count. The DELETE LEFT command ignores count 

Related Conunands . < UNDO > 



3.5.4 <DELR> 

The DELETE RIGHT command is configurable usually as < CTRL-A > . It deletes 
all characters to the right of the cursor on the line on which the cursor is positioned, 
except for the carriage return/line feed pair. 

The deletion can be recovered with the < UNDO > command. 

Count. The DELETE RIGHT command ignores count. 

Related Commands. < UNDO > 



3.5.5 <DELLI> 

The DELETE LINE command is configurable, usually as < CTRL-Z > . It deletes 
the entire line on which the cursor is positioned. All lines below the deleted line move 
up one row. The cursor is left in the same position on the new line. 

The deletion can be recovered with the < UNDO > command. 

Count. The DELETE LINE command ignores count. 

Related Commands . < UNDO > 



3.6 <UNDO> Command 

The UNDO command is configurable, usually as < CTRL-U > . It restores charac- 
ters deleted by the last DELETE LEFT, DELETE RIGHT, or DELETE LINE 

command at the current cursor position. If the previous command was DELETE 
LINE, the cursor moves to the beginning of the current line before the restoration. 
Consecutive < CTRL-U > s repeat the restoration of the same string. 
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Related Commands. < DELL > , < DELR > , < DELLI > 



3.7 <HEX> Function Key 



The < HEX > prrfix (usually configured to < CTRL-H > ) is used to insert a 
character into the text as its ASCII vakm. This feature is useful in the following 

cases: 

• When the character to be inserted has no key; e.g., a character with a hexadeci- 
mal value over 7FH. 

• When the character to be inserted has a special function in the current mode, 
e.g., if you want to insert the < ESC > character into your text. 

To insert a character using < HEX > , you should type < HEX > , then two digits 
that are interpreted as the ASCII value of the character. < HEX > is unseen and not 

inserted; however, it directs the treatment of the next two characters. For example, 
if, in INSERT mode, you type < HEX > 5A, the letter Z will be inserted at the 
mxsoT position. 

< HEX > can be activated under INSERT, XCHANGE, and line-edited prompts. 
It cannot be activa^ at main command level. 



INSERT mode allows you to enter text. To enter INSERT, press I. To exit INSERT 
mode and return to main commi^d hsfs^ press < "BSC > . 

3.8.1 Description 

Press 1; AEDIT-86 prompts — 
[insert] 



The prompt [insert] is di^lapd wi^M j4EWT-M m m INSERT mode. Move the 
cursor to any location in the text and begin typing; the characters are inserted into 
the text. 

< ESC > causes the editor to leave INSERT mode and return to main command 
level. 

The cursor movement commands ( < LEFT > , < RIGHT > , < UP > , < DOWN > , 
or < HOME > ), the delete keys ( < RUBOUT > , < DELCH > , < DELLI > , 

< DELL > , < DELR > ), and < UNIX> > all function the same as they do at main 
command level. 

The cursor movement commands and the delete keys restart INSERT mode at the 
new location. 

< RETURN > inserts a carriage return/line feed pair and moves the cursor to the 
beginning of the next line. 



3.8 INSERT Mode 
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< CTRL-C > deletes all text inserted since the beginning of INSERT mode, or since 
INSERT mode was restarted by one of the following commands: cursor movement 
commands (< LEFT > , < RIGHT > , < UP > , < DOWN >) or delete keys 
( < DELCH > , < DELLI > , < DELL > , < DELR > ). but does not restore charac- 
ters deleted with < RUBOUT > , < DELCH > , < DELLI > , < DELL > , or 

< DELR > . After restoration, < CTRL-C > returns the editor to main command 
level. 

The < HEX > , < MEXEC > , < FETN > , and < FETS > functions described here 
are the same in both INSERT and XCHANGE modes. 

< HEX > is unseen and not inserted. The next two characters, which must be 
hexadecimal digits, are interpreted as the hexadecimal values of a character. < HEX > 
is described above. 

< MEXEC > is the macro execution key. This character is unseen and not inserted. 
When < MEXEC > is pressed, the next character is treated as a macro name. 

< MEXEC > is described in detail in Chapter 5. 

< FETN > is the fetch numeric key. This character is unseen and not inserted. When 

< FETN > is pressed, the next character (which must be a numeric value from 0-9) 
fetches the assigned value. < FETN > is described in Chapter 6. 

< FETS > is the fetch string key. This character is unseen and not inserted. When 

< FETS > is pressed the next character (which must be a numeric value from 0-9 
or the second letter from the read-only string variables) fetches the assigned value. 

< FETS > is desaibed in Chapter 6. 

In INSERT mode, macro execution usually restarts the insert process. The only 

exceptions are non-modeless macros that consist of nonrestarting commands only. 
(See Section 5.3, "Macro Modes," for a description of modeless and non-modeless 
macros.) 

INSERT mode is modified if it is preceded by a forward slash (/). All text past the 

cursor in the current line is moved down one line. The text is restored before any 
delete or move subcommand (except < RUBOUT > ) or when insertion is complete. 

Count . Repeat count is not a valid option in INSERT mode. 

Refaited Craunands. SET Indrat, SET Autonl 

3.9 XCHANOEMode 

XCHANGE mode allows you to type over text. To enter XCHANGE, press X. To 
exit XCHANGE moite and return to main command level, press < ESC > . 

3.9.1 Description 

Press X; AEDIT-86 prompts — 
[exchange] 

The prompt [exchange] is displayed whenever AEDIT-86 is in XCHANGE mode. 
Move the cursor to any location in the text and begin typing; characters are replaced 
on a one-for-one basis. The carriage return/line feed pair is not replaced; instead, the 
line is extended. 
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< ESC > causes the editor to leave XCHANGE mode and return to maifl command 
level. 

The cursor movement commands < LEFT > , < RIGHT > , < UP > , < DOWN > , 

< HOME > , and the delete keys (except for < RUBOUT > ) < DELCH > , 
<DELL>, <DELR> and <DELU>,mi <UNDO> work as at main command 
level. 

The cursor movement commands and the delete keys restart XCHANGE mode at 
the new location. 

< RUBOUT > replaces the character to the left of the cursor with the original 
character (if it has been exchanged), with the following exceptions: 

• If the line has been extended, < RUBOUT > w^rks as at main command level 

and deletes the character immediately to the left of the cursor. 

• If the cursor is at the original replacement location, < RUBOUT > moves one 
character to the left but does not delete the character. 

< RETURN > replaces the character "under" the current cursor position with a 
carriage return /linefeed pafft* tffli n*ewss fte ieursor to the be^iifng of the next line. 

< CTRL-C > restores original text (text before it was exchanged). However, once 
you have exchanged text and pressed < ESC > or restarted XCHANGE with any of 
the cursor movement comnjaodii ( < LEFT > , < RIGHT > , < UP > , < DOWN > , 
or < HOME > ), changes cmmk im mte^i by pressing < CTRL-C > . After resto- 
ration, < dlti^ y returns the editor ^ t^ nmn gcnnmand level. 

The < HEX > , < MEXEC > , 4 FETN > , andit* MfKS > functions described here 
are the sai&ul^ INSERT and XCHANGE mo6e&. 

< HEX > is unseen and not inserted. The next two characters, which must be 
hexadecimal digits, are interpreted as the hexadecimal values of a character. < HEX > 
is described above. 

< MEXEC > is the macro execution key. This character is unseen and not inserted. 
When < MEXEC > is pressed the next character is treated as a macro name. 

< MEXEC > is described in Chapter 5. 

< FETN > is the fetch numeric key. This character is unseen and not inserted. When 

< FETN > is pressed, the next character (which is a numeric value from 0-9) fetches 
the assigned value. < FETN > is described in Chapter 6. 

< FETS > is the fetch string key. This character is unseen and not inserted. When 

< FETS > is pressed, the next character (which is a numeric value from 0-9 or the 
second letter from the read-oply string variables) fetches the assigned value. < FETS > 
is described in Chapter 6. 

Macro execution in XCHANGE mode usually restarts the XCHANGE process. The 
only exceptions are non-modeless macros that contain non-restarting commands only. 
(See Section 5.3, "Macro Modes," for a description of modeless and non-modeless 
macros.) 

Count . Repeat count is not a valid option in XCHANGE mode. 

Error. "Xchange limit is 100" is displayed if you attempt to exchange over 100 
characters without restarting XCHANGE mode. XCHANGE mode has a limit of 
100 characters. 
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3.10 FIND Command 

The FIND command searches forward from the current cursor position to the end of 
the file for a string of characters and positions the cursor after the next occurrence 
the string. 



3.10.1 Description 

Press F; AEDIT-86 prompts— 

<HOME> to re-edl t 

Find imode} " targeLstring" 

The last target string (if any) is displayed within quotes, mode refers to the SET 
options currently in effect that may influence the FIND command. 

Note that pressing < RETURN > when specifying a target string inserts a carriage 
return/line feed into the target string and adds the RETURN symbol, < nl > , to the 
prompt line. You must ^eis& < ESC > to comptete the string sp(»ification and execute 
the FIND command. 

The cursor is placed immediately after the next occurrence of the target string. If the 
string is not found, the message "not found: "target string" " is displayed in the 
message line and the FIND command ih marked as failed. 

The following attributes a^ect operation of the FIND command: 

• Case — consider ca^ of Find target 

• Showfind — list lines or multiple finds 

• K_token — find only token strings 

Case, Showfind, and K_token refer to features set using the SET command, which is 
described later in this chapter. 

Case refers to upper- or lowercase letters. If Case is no, upper- and lowercase letters 

are equivalent. 

If Showfind is yes, each line that contains the target string is displayed. 

The Token is the argument between delimiters. Token characters are all characters 
that are not delimiters. For example, if you want to find the word is in the preceding 
paragraph, but not the is in displayed. If SET K_token is yes, each occurrence of the 
word is is found because it is enclosed in delimiters. 

The string { mode } contains an abbreviation for the. features, Case (Cs), Token 
(Tk), and Showfind (Sh). The abbreviation is displayed only if the specified feature 
is set to yes. If more than one feature is yes, the features are separated by a blank. 

The following are examples of mode: 

FIND { Cs > Consider case = yes 

FIND { Tk Sh } Token and Showfind = yes 

FIND { > No option is set 

To abort a (-)FIND command, press < CTRL-C > . 

The message "found: count" is displayed when the conmiand is complete. 
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Count. The FIND command accepts any count where count indicates the number 
of times to search for a target string. The search stops after the la^ occurrence of 
the target string is found or count is exhausted. 

Error, "not found: target_string" is displayed if no match is found, and the editor 
returns to main command level. 

Related Commands. SET Case, SET K^token, SET Showfind 



3. 1 1 -FIND Command 

"She -FIND command is identical to tlwFlNiy ecMttiBand with the following excep- 
tions: 

• -FIND searches backward from the current cursor position to the beginning of 
the file. 

• The Showfind option is ignored. 

• The cursor is positioned on the first da^metm 0i the oiatched string. 
3.11.1 Description 

Press -; AEDIT-86 irom^s— ^ 

<HOME> to re-«tilt 

-find imoctey "targetJString" 

The last target string (if any) is displayed in the quotation marks. 
Related Commands. SET Case» SET K^token 

3.12 REPLAiE Oomfnimtf 

The REPLACE command is similar to the FIND command except that it allows you 
to replace the old target string with a new string* Tlie REPLACE command also 
allows you to delete a target string. 



3.12.1 Description 

Press R; AEDIT-86 prompts — 

<HOME> to re-edit 

Replace { mode } " target_string " 

The last target string (if any) is displayed within the quotation marks. 

The prompt line contains two line-edited argument. You may edit either or both of 
them in the following ways: 

• Press < HOME > to enter the r^it tfiode; to enter a new target string simply 

type the new string. 

• Press < ESC > to terminate editing the target string and start editing the 
replacement string; AEDIT-86 pitHflpts— 

<HOME> to re-edit 

Replace {mode} "target-String" with " replacement^string" 
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• If you want to return to editing the target string, press < RUBOUT > with the 

cursor on the first position of the replacement string. 

• Press < ESC > if you are on the target string and < RUBOUT > if you are on 
the first character of the replacement string to reedit the target string and the 

replacement string as necessary. 

• Press < ESC > while editing the replacement string to terminate editing the 
target/replacement strings and to start the replacement process. 

To delete a target string from text, the replacement string must be an empty string. 
The first time you request REPLACE, the replacement string will be an empty string; 
therefore, press < ESC > to enter an empty replacement string and execute the 
REPLACE command. If a replacement string from a previous command is displayed, 
type a character and press < RUBOUT > to remove the character. Then press 
< ESC > a second time to enter the empty replacement string and execute the 
command. 

Operation of the REPLACE command is affected by the following attributes (equiv- 
alent to the FIND command): 

• Case — consider case of Find target 

• Showfind — list lines or multiple fincfa 

• K_token — find only token strings 

Case, Showfind, and K_token refer to features set using the SET command, which is 
described later in this chapter. 

Case refers to upper- or lowercase letters. If Case is no, upper- and lowercase letters 
are equivalent. 

If ShowHnd is yes, each line that contains the target string is displayed. 

The string {.mode} contains an abbreviation for the features. Case (Cs), Token 
(Tk), and Showfind (Sh). The abbreviation is displayed only if the specified feature 
is set to yes. If more than one feature is y^ the feature are separat(»l with a blank. 

To abort a REPLACE command, press < CTRL-C > . 

The message "found: count replaced: <x)unt" is dismayed when the command is 
complete. 

The (?)REPLACE and (-)FIND commands share the same target string and each 
changes the other's default target. 

Count. The REPLACE command accepts any count where count indicates the 
number of times to replace a target string. Replacement stops after replacing the last 
occurrence of the target string or count is exhausted. 

Error, "not found: target-String" is displayed if no match is found, and the editor 
returns to main command level. 

Related Commands. SET Case, SET K^token, SET Showfmd 

3.13 7REPLACE Command 

The 7REPLACE command is the conditional REPLACE command. 

3.13.1 Description 

Press ?; AEDIT-86 prompts— 

<HDME> to re-edit 

? R e p 1 B c e { mode i " target-String " 
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The 7REPLACE works exactly the same as the REPLACE command except that 
the following prompt is displntpd on each find: 

ok to replace? (y of fn]} 

If y (or Y) is typed, the replacement is made. Any dft^fcSf'is eooffidered a negative 
response. 



3.14 TAG Comimmd 

The TAG command allows you to specify four locations in a file and, with the JUMP 
command, move the cursor to one of these locations. The TAG command relates to 
the current cursor position. Tags are invisible and are not saved when you exit the 
file. After the tag is set, the editor automatically returns to main command level. 



3.14.1 Description 

You can set four tags: A, B, C, and D. 

The cursor's current position ^femnines the tag location. 

Press T; AEDIT-86 prompts — 

A_tag B_tag C_tag D_tag 

The tag is set by pressing A, B, C, or D. 

If the section containing the tag is deleted, the tag is "moved" to the first position 
after the deleted section. 

Each input ^e (main or OTHER) has its own set of tags. 
Coimt. The TAG command ignores count. 

Error . "invalid command" is displayed if a key other than A, B, C, or D is pressed. 
AEDIT-86 returns to main coomiand level 

Related Commands. JUMP 

3.15 JUMP Command 

The JUMP command moves the cursor to a specified location in text. The editor 
automatically returns to main command level. 

3.15.1 Description 

Press J; AEDIT-86 prompts — 

A_tag B_tog C_tag D_tBg Start End Line Position 
CouBt. The JVMPieonmiiM ^ftiilm &mm: 
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A_ta9, B_tag, C.tag, Djtag 

The Tag subcommand is executed by pressing A, B, C, or D. The cursor jumps to the 
specified tag, previously set with the TAG eoinmaad- 

Error, "no such tag" is displayed if the specified tag does not exist. 

Related Command . TAG 

Start 

The Start subcommand is executed by pressing S. It moves the cursor to the start of 
the fde. 

End 

The End subcommand is executed by pressing E. It moves the cursor to the end of 
the file. 

Line 

The Line subconomand is executed by pressing L. It prompts for a decimal value: 
line: 

The cursor jumps to the start of the designated line. (The first line of a file is number 
1; the maximum value allowed is 65536.) If the value entered is greater than the 
number of lines in the file, the cursor jumps to the EOF marker. 

Error, "illegal value" is displayed if a value larger thaa the maximum value or any 
other illegal value is entered. 

Position 

The Position subcommand is executed by pressing P. It prompts for a decimal value: 
column: 

The cursor jumps to the designated position in the current line. The first position in 
a line is 0; the maximum value allowed is 254. 

• If the current line is shorter than the designated position value, the cursor jumps 
to the last position in the line. 

• If there is no character at the specified position (due to tab expansion), the cursor 

jumps to the next character. 

Error, "illegal value" is displayed if a value larger than the maximum value or any 
other illegal value is entered. 



3.16 BLOCK Command 

The BLOCK command is invoked by pressing B (or D; typing either B or D initially 
is equivalent). The BLOCK command allows you to delimit a section of text that can 
then be deleted, nooved, or copied. The subcommand determines if the text will be 
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deleted, moved, or copied. The Buffer subcommand copies the delimited section to 
the Block buffer. The Delete subcommand deletes the delimited section and places it 
in the Block buffer. The Put sobwMBKftMl ©spies the section to an external file. 

The commands (-)FIND, JUMP, and the cursor movement commands < LEFT > , 
< RIGHT > , < UP > , < DOWN > , < HOME > , and < RETURN > work the same 
as at main command level. 

Text saved in the Block buffer (or in an external file) can be retrieved with the GET 
command. The GET command copies the contents of the Block buffer (or external 
file) at the current cursor position in '^©ifffifB. 

Pressing < ESC > returns the editor to main command level with the cursor left in 
its current position. 

Pressing < CTRL-C > returns the editor to main command level with the cursor at 
its original piMtta at the beginning of the delimited section. 



3.16b1 BloetoOuffer 

The Block buffer is the buffer associated with the BLOCK and DELETE (and GET) 
commands. It has a fixed maximum size of 2 Kbytes. If the section to be copied to 
the Block buffer is over 2 Kbytes, the remainder is written to a temporary work file. 
The contents of the buffer remain unchanged until y@u execute another BLOCK or 
DELETE command, when a new section of text is written to the buffer, overwriting 
the old contents. 



3.16.2 Description 

To delimit a section of text, move the ewPsor to the first cbaxacter of the section. 
Press B or D; the @ sign serves as the delimiter and replaces the character marking 
one endpoint of the block. Endpoints can be set in either order; this example sets the 
beginning endpoint first. 

Press B (or D); AEDiT-86 p»«i(ts-* ' 

Buffer Delete Find -find Jump Put 

Move the cursor to the character immediately after the block to be delimited. The 
character under the first @ sign is included in the block, but the character under the 
second @ is not. 

Now specify one of the subcommands by pressing the initial letter of that subcom- 
mand. 

Count . The BLOCK command ignores count. 
Related Command . GET 

Buffer 

To execute the Buffer subcommand, press B. It copies text to the Block buffer. The 
@ signs are removed; the delimited section of text is copied to the Block buffer. The 
delimited section of text is not affected. 



1 
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To execute the Delete subcommand, press D. It deletes the delimited section from 

the text and moves it to the Block buffer. If the deleted text does not fit in the portion 
of the Block buffer that is in memory, the menu prompts — 

cannot save in m e m o r y - - s a v e anyway? ([y] or n) 

If n is specified, the delimited section of teKt is deleted, but the Block buffer is not 
updated. If you press any other key, the delimited section is written to a temporary 
file. Press < CTRL-C > to abort the command. 

Find 

To execute the Find subcommand, press F. It works the same as it does at main 
command level. 

-find 

To execute the -find subcommand, press the hyphen (-). It works the same as it docs 
at main command level. 

Jump 

To execute the Jump subcommand, press J. It works the same as it does at main 
command level. 

Put 

The Put subcommand allows you to copy a section of text to a named output file. 

Press P; AEDIT-86 prompts— 

<HDME> to re-edit 

Output file: filename 

The filename of the previous command (if any) is displayed to the right of the colon. 
The delimited section of text may be copied to this file or a different filename may 
be specified. The delimited section is not affected. 

If the specified file already exists, the editor beeps and the following prompt is 
displayed: 

overwrite existing file? (y or In]) 

If J' is specified, the delimited text is written to the named file, overwriting the previous 
file. 

If any other key is typed, the editor returns to the BLOCK Put prompt level. 

The specified file can also be written to an output device (e.g., :lp;) supported by your 
system. 

3.17 DELETE Command 

To invoke the DELETE command, press D. The I>ELETE command exists to enable 
deletion of a sectic«i of text by typing D at both endpoints. 
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3.18 GET Command 

The GET command retrieves the contents of the Block buffer or an external file and 
inserts it at the current cursor position in your file. 



3.18.1 Dmeilpildti 

Move the cursor to the point in your file where you want the e«a»tcnte of the buffer 
(or external file) to be placed. 

Press G; AEDIT-M ^mpts— 

<HOME> to re-edit 

Input file:. Rename 

The filename previously specified for the Get command (if any) is displayed to the 
right of the colon. 

To insert the contents of the Block buffer at the current cursor location, press 
< RETURN > . To insert the contents of an external file, type the name of the file, 
then press flPC > or < RETURN >. 

The editor returns to main command level with the cursor on the first inserted 
character. 

Count. This command accepts any finite count. The named file is copied to the 
current location count times. The repeat count / is not valid with the GET command. 
If /G is typed, AEDfT-86 returtts to ittain ccmimaiid level without issuing an error 
message. 

Related Command. BLOCK 



3.19 VIEW Command 

To execute the VIEW command, press V. This command allows you to rewrite (move) 
the text on the screen so that the row containing the cursor (the viewrow) is positioned 
on the row that you have defined. In this way you may rewrite (move) the text area 
you are editing to position the viewrow on line 10, for example. VIEW is also useful 
to refresh the screen image if it has been corrupted (e.g., power failure, terminal 
problems). The viewrow is set with the SET Viewrow command; the default is 5. 
Reverse scroll is implemented as VIEW on terminals without reverse scroll. 

VIEW also issues an abbreviated sign-on message, which includes the busy /waiting 
indicator, s^U&m-M, and AEDIT-86 version number. 

Count. Tire VIEW command ignores count. 

Related Command. SET Viewrow, WINDOW 

3.20 OTNli Command 

AEDIT-86 has two distinct buffers. The text area used at startup is called the main 
buffer; the other is called the OTHER buffer. To execute the OTHER command, 
press O. It allows you to switch from editing text in one buffer, the current buffer, to 
editing text in the other or secondary buffer. 
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Pressing O a second time returns the editor to the main buffer. 

Main and OTHER buffer text may be displayed simultaneously by splitting the screen 
into two windows using the WINDOW command. 



3.20.1 Description 

Press O; the message "Other Editing input file" or, if no input file has been specified, 
"Other no input file" is displayed at the start of the message line whenever the 
secondary text is displayed: 

Other Editing input file 

Again Block Calc Delete Execute Find -find --more-- 

The OTHER buffer allows you to edit a second file in the same way as the main 
buffer. 

It is possible to display both the main and the OTHER text buffers by splitting the 
screen into two windows using the WINDOW command, then typing O to display 
the OTHER file in one window. In this case, switching from one window to the other 
results in switching from one text buffer to the other. 

Each partition has a separate set of tags. A JUMP command is valid only within its 
own partition; it cannot jump to the other partition. Also, each partition has its own 
value for SET Leftcol. The Block buffer is common to allow moving text between 
partitions. 

Press O to exit the OTHER buffer and return to the main buffer. 
Count. Count has no meaning for the OTHER command. 



3.21 AGAIN Command 

To execute the AGAIN command, press A. It causes the last command or in some 

cases the last subcommand to be repeated. 

In the following commands, AGAIN repeats the entire command, including subcom- 
mand arguments: 

• PARAGRAPH 

• (-)FIND, (?)REPLACE 

In the following command, AGAIN repeats the entire command including subcom- 
mands, but without their arguments: 

• HEX command 

Count . Count is the count for the repeated command. The value of count given for 
the last command is ignored. 



3.22 SET Command 

The SET command allows you to set/reset several features that determine how 
AEDIT-86 will operate, e.g., if case (uppercase, lowercase) should be considered in 
the target string of a search command. 
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Most SET subcommands relate to switches. A switch is an option that has only two 
states: yes or no. When a subcommand of this type is activated, a yes/no question is 
displayed on the prompt line, ^tim value currently in effect is enclosed in square 
brackets. Each feature has a default value; this value is in effect until it is reset using 
the SET command. 

3.22.1 DescrifHton 

Press S (press < TAB > to view the remainiag prompt lines); AEDIT-86 prompts — 

AutQnl BBk_file Case Sltfilfty E_dellnit Go Highblt --nore-- 
Indent K_ token Left col Margin Notab Radix Showfind '-torc-- 

Taba Viewrow --more-- 

To specify an option, press the initial (uppercase) letter of that option. 

Count . The SET command ignores count. 

AutonI 

To activate the AutonI option, press A. This option allows you to automatically create 
a new line at the right margin, in INSERT mode. It prompts — 

iTisert cr,lf automatically? (y or [nl) 

• If y, carriage return/line feed (new line) is inserted in the last position on the 
screen whenever an attempt is made to insert a character in that position. If the 
character to be inserted is not a white space (i.e., not a space, tats, line feed, or 
carriage return), the carriage return/line feed pair is inserted before the token, 
if possible. Trailing blanks and tabs are deleted, and the carriage return/line feed 
is inserted between words. The last position is set using SET Margin (described 
later). 

• If n, the option is turned off. 

Related Commands. INSERT, SET Margin 

Bak_file 

To execute the Bak-file option, press B. It saves a backup file that contains the last 
version of your file. It prompts — 

create .BAK files? ([y] or n) 

• If >>, the file you are editing is renamed file. BAK when QUIT Exit or QUIT 

Update is executed to save the revised version of the file. 

• If «, this option is turned off. 

NOTE 

Turning off this option cm be dangerous. If your file is accidentally lost or 
damaged and Bak-file is yes, th<6 most recent version of the file has been 
saved in the backup file. 

Case 

To execute the Case option, press €. ll ^aisiders the case of the target string in a 
search command. It prompts — 

consider case of Find target? (y or [n]) 

• If y, you can type the target strings in upp^ease, lowercase, or a combination of 

both, and the case is significant. 

• If n, you can type the target string in upptrease, lowercase, or a combination of 
both, but the case is ignored. 
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For example. 

If the target string for the FIND command is tHe and the option is set to y, AEDIT- 
86 will find tHe only. 

If the target string for the FIND command is tHe and the option is set to n, AEDIT- 
86 will find tHe, the, THE, etc. 

Related ctwunaads. (-)FIND, (?)REPLACE. 
Display 

To execute the Display option, press D. This options allows you to display the text 
changes resulting from macro execution. It prompts - 

display macro execution? (y or [n]) 

• If y, during macro execution all cursor movements and text changes are displayed 
on the screen. 

• If «, this option is turned off. Thus, wlien macro execution starts, cursor 
movements or changes in the text are not displayed on the screen. 

For example, if you execute a macro and SET Display Yes is in effect, sections of 
text that are changed by the macro execution are displayed on the screen each time 
the macro is executed. 

E_iieliinit 

To execute the E_delimit option, press E. The current delimiter set may be displayed 
and new delimiters set using this option. SET E_delimit is used by the FIND/ 
REPLACE commands under token mode. It prompts — 

<HDME> to re-edit 

delimiter set: !"# X »'()•+,-./:;<■>?§[ \ ]"'{!}" 

All characters currently specified as delimiters are displayed to the right of the colon 
on the prompt line. 

Delimiters have the following properties: 

• A delimiter is always one character. 

• Characters with hexadecimal values from 00H-20H, and 7FH or more are 
predefined delimiters. They are not displayed, and they cannot be excluded from 
the delimiter set. 

• ASCII characters with the values 21H-7EH are displayed (if specified). 

• Delimiters are displayed with no separating characters 

Delimiters specified by SET E_delimit are used to define a token for the (-)FIND/ 
(?)REPLACE operation. A token is any nonempty string surrounded by delimiters. 

When you specify a set of delimiters, you may include the same delimiter more than 
once. For example, you may separate input delimiters with blanks. 

The default E_delimit string is — 

!"#Xl'()«+,-./!;<->?#[ \ ]*{|}' 
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Related Commaads. {-)FINI>, (?)REPLACE, SET K_token 
Go 

To execute the Go option, press G. It relates to macro execution continuation after a 
(-)FIND/(?)REPLACE command failed. It prompts— 

continue macro executio ft after a failure? (y or [n]) 

This option is meaningful only in macro execution; it hm ao meaning at main 
command level. The default for the SET Go option, when a macro is started, is No 
for all macros regardless of the current setting of the option. To use this option, you 
should specify SET Go Yes in your macro. It may be reset within the same macro 
file. The SET Go option does not affect a nested macro. 

• If >' is in effect for the current macro file and a (-)FIND/(?)REPLACE command 
fails, execution of the curr^ iiia<»@ coan^oes, Le., the next comnaand is activated. 

. If n is in effect for the current macro file, and a (-)FIND/(?)REPLACE 
command fails, execution of the current macro is terminated, and control is 
return^ tf ^e caller, either a macro or main command level. 

During MACRO Create, the SET Go eomfiiand is inserted into the macro definition, 
but the macro curr^tly defined is executed as if SET Go is Yes. 

Related Commands. MACRO Create, EXECUTE 
HighbR 

To execute the Higlibil option, press H. It allows the display oC characters with 
hexadecimal values over 7FH. It prompts — 

display parity-on characters as is? (y or En]) 

• If y, all text characters with hexadecimal values over 7FH are written to the 
screen as is. 

• If n, all text characters with hexadeciooal values over 7FH are displayed as ?. 
Indent 

To execute the Indent option, press 1. This option is useful when entering code for a 
structured language such as PL/M or Pascal. It prompts — 

automatically indent during insertion? (y or [n]) 

• If >> in INSERT mode and < RETURN > is pressed, the next line is automati- 
cally indented to the position of the first character of the preceding line. For the 
first line (after a blank line), pressing < RETURN > moves the cursor to position 
of the next line. At main command level, the cursor moves to the first nonblank, 
ncmtab cteatacier in the next line. 

• If «, this (06m is turned off. 

The Indent option is not active if a carriage return is inserted using the < HEX > 
piefaJtJ^lMJ^ > OD) or if a luie feed is inserted without a carriage return. 

This option ')$ Mt active in XCHANGE mode. 

Related Commands. Carriage Return, INSERT 
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K^token 

To execute the K_token option, press K. This option allows you to find a string only 
if it is enclosed by delimiters and is not jKirt of a larger string. It prompts — 

find only token strings? (y or Cnl) 

Token characters are all the characters that are not delimiters. A token is defined as 
a nonempty string surrounded by delimiters. Delimiters in this context are the 
characters specified in SET E_delimit. 

• If a string is found by the (-)FIND or (?)REPLACE command only if the 

string fits the token definition. 

A string in the text that is found by (-)FIND or (?)REPLACE commands when 
SET K_token No is in effect will also be found when SET K_token Yes is in 
effect ONLY if that string is a nonempty string surrounded by delimiters. 
Delimiters include the beginning and end of a file, the cursor position, carriage 
return and line feed. 

• If n, a string in the text is found regardless of the characters that surround it. 
Related Commands. (-)FIND, (?)R£PLACE, SET E-delimit 

Leftcol 

To execute the Leftcol option, press L. The option allows viewing lines with more 
than 80 characters. It prtmipts — 

<HOME> to re-edlt 

left column: 

The current left column is displayed to the right of the colon. This command allows 
you to view lines over 80 characters long on the screen and accepts any number from 
to 175 (position count starts at 0). The number input indicates the number of 
characters at the start of a line that should not be displayed. 

For example, if a line is 90 characters long, you can set Leftcol to 20 and the screen 
will display the line from position 21 to the end of the line. 

An exclamation point (!) is printed in column when characters to the left are not 
displayed. 

Leftcol can also be set by typing the plus sign ( + ) or the minus sign ( — ) followed 
by a valid decimal number. This sets the left column at the current value plus or 
minus the number given. 

AEDIT-86 may have two different values for Lefcol simultaneously, one for the main 
file and one for the OTHER file. The default Leftcol for both files is zero. 

For example, if the left column is currently set at position 15 and you type S(ET) 
L(eftcol) -10, the new left column is position 5. 

Error, "bad Leftcol" is displayed if you attempt to set a value out of range. 
Margin 

To execute the Margin option, press M. It allows setting values for indenting, and 
for left and right margins for reformatting a paragraph. It prompts — 

<HQME> to re-edit 

Indent, left, right: 4 , , 76 
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The current values for indent, left, and right are displayed to the right of the colon 
separated by commas. The first number sets the indentation, the second the left 
margin, and the third the right margin. Iwdent may be s©t at any value from 0-253; 

left, from 0-253; and right, from 1-254. The value of the right margin must be greater 
than the indentation and the left margin. When entering the values, separate them 
by one or more blanks or a comma. The values of all three numbers are absolute and 
offset from position 0. The default values are 4, 0, and 76. 

Press < ESC > or < RETURN > to execute the command and return to main 
command level. 

To set indent to 0, left to 5, and right to 70, type — 
Bf FT^ Hf arein^ IMS^MIJAilUJH 

To reset the left margin to 2, type — 
g(ET) |2|(argin) ^iaMIH!li 
Related Commands. PARAGRAPH, SET Autonl 

Notab 

To execute the Notab option, press N. This option instructs the editor to replace 
inserted tabs with the appropriate number of blanks. It prompts — 

insert blanks for tabs? (y or [n]) 

• If V, blanks are inserted instead of tabs whenever yoii press the <TAB > key in 

the INSERT or XCHANGE mode. 

• If n. this option is turned off. 

Note that this option does not affect tabs that are entered using the < HEX > prefix 
( < HEX > 09). 

Related Commands . SET Tab 
Radix 

To execute the Radix option, press R. This option allows you to determine the radix 
(base) in which an AEDIT-86 variable will be inserted in the text. It prompts — 

current Radix: radix 

Alpha Binary Decimal Hex Octal 

This option affects values inserted or exchanged by the Fetch operation < FETN > 
(described in Chapter 6). The Radix default is Deciinal. 

For more on Radix, see Chapter 6. 

Related Commands. INSERT, XCHANGE 

Showfind 

To execute the Showfind option, press S. It is used to display all lines containing the 
target string in a FIND/REPLACE command. It prompts — 

list lines on multiple finds? (y or [n]) 

• If y, when you execute a FIND or ('?)REPLACE command, the screen is cleared, 
and each text line that contains the target string is displayed on the screen. Each 
string is displayed on a separate line. Wfc«i the screen is full, the message "hit 
space to continue" is displayed. 

• If n, the FIND and (?)REPLACE commands execute as usual, but the screen is 
not cleared, iMtf text lines that contain the string are not displayed on the screen. 
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Related Commands. FIND, (?)REPLACE 
Tabs 

To execute the Tabs option, press T. This option allows you to set tabs. It prompts — 

<HOME> to pe-edl t 

Tabs: 4 

The prompt line lists the current tab settings. If you want only to inspect the tab 
settings, type < CTRL-C > to return to main command level. 

To enter tabs, type a list of decimal numbers separated by at least one blank or a 
comma. The numbers must be specified in increasing order, from 1-253. Changing 
the tab settings does not change the file contents, but it may affect its display on the 
screen. 

The default tab settings are every fourth position, i.e., 4, 8, 12... . 

The difference between the last two numbers specified for tabs is repeated, up to 253. 

For example — 

4 sets tabs at 4, 8, 12, 16, ... 

5,6,10 sets tabs at 5, 6, 10, 14, 18, ... 
sets tabs at 4, 8, 12, 16, ... 

NOTE 

Columns start at 0, not 1. Therefore, FORTRAN tabs should be 6,10, not 
7,11. 

Errors, "bad tabs" is displayed if you attempt to set an illegal tab. 
Related Commands. INSERT, XCHANGE 

Viewrow 

To execute the Viewrow option, press V. This option allows you to select a viewrow 
for rewriting the screen. It prompts — 

row for View: 5 

The current viewrow setting is displayed to the right of the colon. Type the number 
of the row on which you wish the cursor to be positioned by the VIEW command. 
This value must be between and the text size — 1 . If, for example, your screen size 
is 25 rows, then text size is 23 (25 minus the message line and the prompt line). 
Therefore, in this case, the legal values are 0-22. 

The default viewrow is the terminal length divided by S, which means 5 on most 
terminals. 

If the screen is split using the WINDOW command, the view row is determined 
separately for each window by a formula based on the current view row and the 
window size. 

Errors, "bad View row" is displayed if viewrow is set to a value greater than text 
size —1. 
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Salted Commands. VIEW, WINDOW 



3.23 HEX Command 

The HEX command allows you to te»t the ASCII equivalsiits of b^adecimal values 
in the text. This command also displays the hexadecimal values of text contents in 
the message line. 



3.23.1 Description 

Press H; AEDIT-86 prompts — 
Input u t im t 

To specify a subo^mnand, press the initial letter of that subcommand. 
Input 

Press I; AEDIT-86 prompts — 

<HQME> to re-edit 

Hex value: 

The last values entered for HEX input are displayed to the right of the colon. Legal 
input values consist of one or more strinp separated fey one or more blanks. A legal 
string has the following characteristics: 

• Every character is a valid hexadecimal digit (0-9, A-F) 

• Contains 1 or an even number of characters 

Values entered are regarded as hexadecimal; therefore, the suffix H is an illegal 
character. The vfilues may be separated by one or more blanks. 

The following are examples of legal input values: 

9 

5A5B60 

3456 65 78FQ 8 98C8A7 

If the input is legal, the equivalent characters are inserted in the text at the cursor 

position. 

Error, "invalid hex value" is displayed if an illegal value is entered, and the editor 
returns to main command levd; 

Output 

Press O. 

The hexadecimal value of the character immediately to the right of the actual cursor 
position is displayed on the mm^e line. The count that preceded the HEX command 
gives the number of bytes to W^k0f^Nti he«jltecimal format. Up to 10 bytes of 

hexadecimal values can be displayed in the message line. If more bytes are to be 

displayed, the message "hit space to continue" is displayed. 

Press the space bar and the next 10 bytes are displayed. Any other key returns 
AEDIT-86 to the miiln command level. 



1 
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3.23.2 Example 
Example 1 

To insert the form-feed character (hexadecimal value OC) to the current location, 
type — 

B(EX) |(nput) BBHB 
Example 2 

To insert the digits I, 2, and 3 to the text, type — 



Position the cursor over the one and type 3 H(EX) O(utput) to display the charac- 
ters. The characters are displayed on the message line. 



The QUIT command performs several functions depending on its subcommand. It 
ends the editing session, it initializes processing a new input file, it updates your 
edited file, etc. QUIT has different prompts depending on whether or not a filename 
has already been specified for the file you are editing. 



3.24. 1 Filename Specified 

Assume you are editing a file with a filename already specified. 

Press Q; AEDIT-86 prompts — 

Editing input file C t o output file 1 

Abort Exit Init Update U r i t e 

To specify a subcommand, press the initial letter of that subcommand. 



To execute the Abort subcommand, press A. When Abort is activated, if any changes 
have been made to the current file, AEDIT-86 prompts "all changes lost? (y or [n])"to 
avoid inadvertent loss of text. A y continues the abort process; the same procedure is 
then applied to the secondary file. Control returns to the operating system only after 
both questions have been answered with y. All changes (if any) that were made to 
the input file(s) are lost. If either question is answered with a response other than y, 
AEDIT-86 returns to main command level 

Note that— 

• You are questioned concerning only input files that have been changed. 

• The first question (if any) relates to the current file and the second one (if any) 

relates to the secondary file. 

• If you answer y to the first question and n to the second while AEDIT-86 is still 
active, the next time you type QUIT Abort, you will not be asked further about 
the file about which you have already answered y unless new changes have been 
made. 



|(EX)|(nput) 




3.24 QUIT Command 



Abort 
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Exit 

To execute the Exit subcommand, press E. When activated, AEDIT-86 rewrites the 
current file. Then, if the secondary file has also been changed, AEDIT-86 automati- 
cally performs the OTHER command and asks "all changes lost? (y or [n])". A y 
returns AEDIT-86 to the operating system without rewriting the secondary file. Any 
response other than y returns the editor to main command level. 

init 

To execute the Init subcommand, press 1. It allows you lo start editing a new file 
without returning to the operating system. If any changes have been made to the 
current file, the menu prompts "all changes lost? (y or [n])". 

Press I; AEDIT-S6 prompts — 

<HOI>IE> to re-*dit 

enter [file tTD filelVOIFO ll: 

Enter the input file (or < RETURN > ) followed optionally either by an output file 
name or by the VO or FO controls. File is the file you want tQ edit, TO file indicates 
the output file, VO is the abbreviation of flW esMw* VltWWLY; FO is the abbre- 
viation of FORWARDONLY. The TO option can be used only when the input file 
exists. These controls are described in Chapter 4. 

UfKlate 

To execute the Update suboQiii^^ .fms» U. It writes the updated version of your 
file witho#ti^iuroing to the operating syst^. 

After the file has been written, the message "ff/e has been written" is displayed. 

After completing the QUIT Update command, the editor is at the QUIT prompt 
level, not at main cmmimd Imiu 

Write 

To execute the Write subcommand, press W. 

The following prompt is displayed — • 

<HDME> to re-edit 

Output file: 

Enter the output filename. If the specified file exists, the editor beeps and the follow- 
ing question is displayed: 

overwrite existing file? (y or [n]) 

• If y, the entire text file is written to the named file overwriting the existing file. 
AEDIT-86 returns to the ^IT prompt level. 

• Any other response retBMf tte @&im the QUIT Write prompt level. 

After the file has been written, the message "file has been written" is displayed. 

The QUIT prompt is always reissued after an Update or Write subcommand. Press 
<ESC> or <CTRL-C> to fetiim lo command level. 
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Note that: 

• QUIT Abort and QUIT Exit relate to the entire AEDIT-86 session, i.e., to botli 
the current file and the secondary file. QUIT Init, QUIT Update, and QUIT 
Write relate only to the file you are currently editing. 

• An output file indicated by the TO clause can be specified for a file in either the 
invocation line or at the QUIT Init command. Only the subcommands Update 
and Exit relate to this output file; Write does not. 

3.24.2 Filename Not Specified 

If you are editing a new file and have not yet specified a filename, the Exit and 
Update subcommands are not available (both subcommands require a filename). The 
AEDIT-86 prompt is altered as follows: 

no input file 

Abort Init Urite 

The subcommands function the same as discussed above. 



3.25 PARAGRAPH Command 

To invoke the PARAGRAPH command, press P. A paragraph is defined as one or 
more nonempty lines preceeded by and followed by an empty (or blank) line. The 
PARAGRAPH command reformats a paragraph using the values set for indent and 
left and right margin in the SET Margin command. Reformatting means rearranging 
or adjusting the words within a paragraph between the right and left margins. A 
word is defined as a sequence of characters surrounded by white spaces (i.e., space, 
tab, line feed, or carriage return). The default is to reformat one paragraph. 

NOTE 

The PARAGRAPH command execution starts by indentifying the begin- 
ning of the current paragraph. AEDIT-86 searches backward for an empty 
line; then, the end of the paragraph is found by searching forward for an 
empty line. This implies that if your file has no empty lines, PARAGRAPH 
will process the entire file as one paragraph, wherever the cursor is currently 
positioned in the file. 

3.25.1 Description 

Move the cursor to any position in the paragraph to be reformatted. 
Press P; AEDIT-86 prompts — 
Fill Justify 

To specify an option, press the initial letter of that option. 

Count . Count defines the number of consecutive paragraphs to reformat. 

Related Commands. SET Margin 

Fin 

Press F to perform filling. This means that the white space sequences are reduced to 
one blank, and every blank after a sentence terminator (e.g., period, question mark) 
is extended to two blanks. Words are moved to fill the line between the right and left 
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margins or from line to line if necessary. The first line is indented according to the 
value of indent. Words are moved to the left as much as possible. Words are not split 
and lines are not right-justified. 

Justify 

Press J to perform justification. He first step is as described in the filling process. 
The second step is performed sepafSt^y for each line: words are shifted to the right 
(if necessary), and the space between words expanded so that the last word of every 
line ends at the right margin and the spaces between words are approximately even. 
The last line of the paragraph is not right-justified. 



3.26 WINDOW Command 

To invoke the WINDOW command, press W. It splits (horizontally) the text area of 
the screen into two partitions. Each partition or window contains the text, message, 

and prompt sections. The WINDOW command allows you to view two different parts 
of the same file or two different files, using the main file and the OTHER file. You 
may, for example, view errors in a listing file in one window and corre«^ the source 
file in the other window. The existence or absence of windows does not affect the 
editing commands. You may think of each window as a narrower screen. 

The screen is split above the cursor row. If the airsw is placed so that one window's 
size is less than five rows, the screen is not splits and the message "window too ^all" 
is displayed. After the screen is split, pressing W causes the cursor to jump between 
the two windows. 

At any given time, only one window is active — the window containing the cursor. 

When the screen is split using the WINPOW command, the view row is determined 
separately for each window by a formula based on the current view row and the 
window size. 

If the same file is displayed in both windows, a change in one window is not reflected 
in the other window until you press W and jump to the other window. 

To return to viewing one screen, see the KrLL_WND command. 

Related Commands. KILL_WND, SET Viewrow, VIEW 



3.27 KOl^WND Command 

To invoke the KILL_WND command, pr^ K. It returns the screen to one window. 
The current (active) window is the dominant one. When the KILL_WND command 
is given, the current window is extended to fill the screen; the cursor remains in its 
current position. If the file displayed in the current window is at the beginning of the 
file when the KILL_WND command is given, it scrolls upward to fill the entire screen. 
This mechanism is indifferent to whefbir the two windows display two different files 
or not. 

Related Commimd. WINEtOW 
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3.28 CALC Command 

To invoke the CALC command, press C. It provides you with computation capabilities. 

3.28.1 Description 

Press C; AEDIT-86 prompts — 

<HOME> to re-edit 

C a 1 c : 

The last statement entered under the CALC command is displayed to the right of 

the colon. 

This command is described in detail in Chapter 7. 

3.29 EXECUTE Command 

To invoke the EXECUTE command, press E. EXECUTE is used to execute Macros. 
3.29.1 Description 

Press E; AEDIT-86 prompts — 

<HOME> to re-edit 

Macro name: 

The last macro name entered for this command is displayed to the right of the colon. 
When typing the macro name is completed, the specified macro is executed. 
This command is d^cribed in detail in Chapter S. 
Related Command . SET Display, SET Go 

3.30 MACRO Command 

To invoke the MACRO command, press M. It is used for manipulating macros. 

3.30.1 Description 

Press M; the menu prompts — 

Create Get Insert List Save 

To specify a subcommand, press the initial letter of that subcommand. 

When a macro file is specified in the invocation line (explicitly or implicitly), it is 
read and processed immediately after AEDIT-86 invocation. This has the same effect 
as using a MACRO Get as the first command after invocation. 
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Macro files are described in Chapter 5; AEDIT-86 invocation is described in 
Chapter 4. 

Rdated Cmraiairi. SET Go 
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CHAPTER 4 
AEDIT-86 INVOCATION 



This chapter describes AEDIT-86 invocation and tie AEDIT-86 controls: 
FORWARKOJ^LYvVIEWQNLYi JllCQlVoER, MACRO, MACROSIZE and 

BATCH. . - 



4.1 Invocation 

Invocation details for a particular system are given in the appendixes. Following is 

the syntax used to invoke AEDIT-86: 

[ device ] A E D I T [ inpuUUe ] T output-file I file processing_mode ] ] 
I recover] 

I , otherJnput_file I TD other_output file I fitetj^rooessingjnnode 1 ] 
[ execution_mode ] 

where 

/'nput file is the file you want to edit. If a file name is not specified, 

a new file is created. It is named when you call the QUIT 

command. 

is the name of the output file. It is the destination file for 
the file you are'^iting if an output file is specified. It is 
written when you call QUIT Update or QUIT Exit. If 
either VIEWONLY or FORWARDONLY is specified for 
the input file, an (wtput file caQoot be specified. 

supply filenames for the OTHBR buffer. 

[ VlBWONL¥'lff©¥lfeWONLY | 
[ FORWARDONLY I NOFORWARDONLY ] 

[ RECOVER I NORECOVER ] 

[ MACRO [ ( macrojile ) ] I NOMACRO ] 
[ MACROSIZE (macro_buffer_size) ] 
[ BATCH I NOBATCH ] 

A coillfli^^^ipgd to separate the main filename frpm the OTHER filename. 



4. 1 . 1 InvcNCj^tton Line Examines 

AEDIT-86 can be invoked simply by naming the file you want to edit, as follows: 



AEDIT MYTEXT.SCR<RETURN> 



Example 2 

This example shows invoking AEDIT-86 with a main input file, an OTHER input 
file, and a macro file: 




output file 



other input file 
ottier output file 

We processing imele 

recover 

execution mode 
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Examples 

The following example shows an invocation of AEDIT-86. The main input file and 
the OTHER input file have the same filename but different filename extensions. The 
controls MACRO and MACROSIZE are also specified. The main filename and the 
OTHER filename can be shortened using a hyphen (-), as follows: 




NOTE 

If the TO option is used and the input file does not exist, then the "File does 
not exist" message is displayed following the invocation line, and AEDIT-86 
behaves as if no input or output values were specified. 



4.2 Invocation Controls 

AEDIT-86 controls can be divided into three groups: file processing mode controls, 

recover control, and execution mode controls. Table 4-1 lists the AEDIT-86 invoca- 
tion controls. The remainder of this chapter explains each control in detail. 

The processing mode for an input file uses the VIEWONLY and FORWARD- 
ONLY controls. 

• These controls can be specified for either the main input file, for the OTHER 
input file, or both. VIEWONLY and FORWARDONLY cannot be specified 
together for the same file. However, if either of them is specified in the negative 
form, any combination is legal, e.g., NOVIEWONLY FORWARDONLY. 

• A filename must be given if either of these controls is specified in the positive 
form in the invocation line. 



TaUe4^1. A^MT^M iMooiiiW (Jalitrois 



Control Namo 


AbbrevlaUon 


Default 


Meaning 


File Processing Mode Controls 


FORWARDONLY/NOFORWARDONLY 

VIEWONLY/NOVIEWONLY 


FO/NOFO 
VO/NOVO 


NOFO 

NOVO 


Enables faster editing 
of large files, but the 
size of the edited file is 

limited. 

Enables fast viewing of 
large files; no changes 
allowed. 


Recover Control 


R ECOVER/NORECOVER 


RC/NORQ 


NQRC 


Enables file recon- 
struction. 


Execution Mode Controls 


MACRO/NOMACRO 
MACROSIZE 

BATCH/NOBATCH 


MR/NOMR 
MS 

BA/NOBA 


MR(TOOf.MAC) 
MS(3072) 

NOBA 


Specifies macro file. 

Allocates macro buffer 

size. 

Activates AEDIT-86 In 
non-interactive mode; 
used if AEDIT-86 is 
activated from a 
command file. 
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• When an output file is specified, these contR^ Bsay be ^ecifled only in their 
negative form, e.g., NOVIEWONLY. 

• VIEWONLY and FORWAEDOIILt' are Ihe ^ COTtrols that can be speci- 
fied under QUIT Init. 

The {H-ocessing mode for the main input file uses the RECOVER control. 

• This control may be specified only in the invwation line and only for the main 
input file. 

The execution mode uses the MACRO, MACROSIZE, and BATCH controls. 

• These controls may be specified once per AEDlT-86 invocation. They cannot be 
specified for a particular file, and they cannot be specified under QUIT Init. 

A control may be specified only once, except for VIEWONLY and FORWAR- 
DONLY, which may be specified once for the main input file and once for the 
OTHER input file. 
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4.2.1 FORWARDONLY 

Syntax 

FDRUARODNLY I N F Q RM A R D N L Y 

Abbreviation 

[ N D ] F 

Default 

NOFORUARDONLY 
Control Type 

Processing mode for an input file 
Description 

FORWARDONLY allows much faster editing of large files because it instructs 
AEDIT-86 to allocate a fixed amount of memory for the file. If the file is larger than 
the amount of memory allocated, some text may be lost. This loss applies only to the 
current editing of the file; the original file is not affected. 

FORWARDONLY can be specified for either the main input file or the OTHER 
input file. FORWARDONLY can also be specified under the QUIT Init command. 
FORWARDONLY cannot be specified simultaneously with VIE WON LY. When 
FORWARDONLY is in effect for the input file, an output file may not be specified. 

While the FORWARDONLY control is in effect, the message line displays the word 
Forward. 

Error, "some text lost" is displayed if text is lost during the current edit. If this error 
is displayed, you are unable to execute QUIT Update or QUIT Exit; however, you 
may execute QUIT Write. 
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4.2.2 VIEWONLY 

Syntax 

VIEUOHLY I HOVIEUONLY 

Abbreviations 

[ NO ] VO 

Detauit 

HOVIEUONLY 
Control Type 

Processing mode for an input file 
Description 

A large file, e.g., a large listing file that you do not want to change, may be viewed 
much faster usingj'the ¥IBWONLY control. M h an advantage to use 
VIEWONLY if you want to be certain that no changes are made unintentionally. 

VIEWONLY can be specified for either the main input file or the OTHER input 
file. VIEWONLY can also be specified under the QUIT Init command. VIEWONLY 
cannot be specified simultaneously with FORDWARDONLY. When VIEWONLY 
is in effect for the input file, . aa ou^t f ite may not be specked. 

If the VIEWONLY control is specified, the input file may not be changed. The 
following function keys are not valid with VIEWONLY: < RUBOUT > , 
<DELCH>, <DELL>, <DELR>, <DELLI>. 

The following commands are still displayed on the prompt line; however, they are not 
valid with VIEWONLY: (?)REPLACE, BLOCK Delete, GET, HEX Input, 
INSERT, MACRO Insert, MACRO Save, PARAGRAPH, QUIT Exit, QUIT 
Update, QUIT Write, and XCHANGE. 

All other commands are legal. Note that you may save a VIEWONLY file or a 
portion of it using the BLOCK Put conunand. 

While the VIEWONLY control is in effect, the aiesistge line displays the word View. 
Error, "illegal command" is displayed if an illegal command is given. 
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4.2.3 RECOVER 

Syntax 

RECOVER I NQRECOVER 

Abtireviations 

t NO ] RC 

Default 

NORECOVER 

Control Type 

Processing mode for the main input file on invocati<m 
Description 

The RECOVER option can be used to help you reconstruct edited files if a fatal 
system error occurs during AEDIT-86 operation or if an unintentional termination 
of an AEDIT-86 session occurs using QUIT Abort. 

If a crash occurs, reinvoke AEDIT-86 with the RECOVER control. The RECOVER 
control can be specified only for the main input file and only in the invocation line. 

When RECOVER is specified, AEDIT-86 takes the entire memory contents as the 
input file. If the memory contains previously edited file(s), your file must be recon- 
structed. RECOVER is, however, only a means for the reconstruction — you must 
identify, gather, and connect the relevant text portions in memory. 

RECOVER may be used only if the memory allocated to AEDIT-86 in the current 
activation is the same as that used in the previous activation. This implies that 
RECOVER is probably useless on virtual-memory-based systems or in a multitask 
environment. 

The reconstruction process is difficult or impossible if the edited file is so large that 
it is spilled to exUra memory or to temporary flies. The n^mory content in such a 
case does not reflect the entire file ^ytrats. 

If an input file is specified, the input file is not read when RECOVER is in effect, 
but it serves as an output file for the QUIT Update command. 
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4.2.4 



MACRO 



Syntax 



MACRO [ 



( macro^file ) ] I NOMACfiO 



Abbreviations 



[ NO ] MR 



MACRO ( AEDIT_/!f/en8iTie.NA6 ) 

Control Type 

Execution mode 

Description 

The MACRO control allows you to specify a macro file for the current AEDIT-86 
invocation. The NOMACRO option prevents AEDIT-86 from reading a macro file. 
Not specifying this control or just specifying MACRO is equivalent to the default. 
When the MACRO control is specified with a filename, the filename can have any 
extension. The subject of macro files is mom thoroag Uy described in Part II. 
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4.2.5 MACROSIZE 

Syntax 

MACROSIZE f inacro_buffer^size J 

Abbreviations 
MS 

Defautt 

MACROSIZE ( 3072 ) 

Control Type 

Execution mode 

Description 

This control is useful to allocate more macro buffer space if, for example, a huge 
batch operation is implemented using macros. Also, more macro space may be required 
if many or long macros are used. The subject of macros and macro files is more 
thoroughly described in Part II. 

MACROSIZE allows you to specify the macro buffer size for the current 
AEDIT-86 invocation. macroJbuffer_size is a decimal number specifying the number 
of bytes to be allocated. The minimum macro_buffer_size is 1024 (400H) bytes; the 
formal maximum allowed is 32767 (8000H) bytes. The default size is 3072 bytes. 
The maximum size actually allowed also depends on the amount of RAM available; 
therefore, it may be less than the formal maximum. 

Buffer that is allocated for macros is not available for text; therefore, allocating a 
large macro buffer is not recommended. 
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4.2.6 BATCH 

Syntax 

BATCH I NOBATCH 

Abbreviations 

[NOIBA 

Default 

NOBATCH 

Control Type 

Execution mode 

The BATCH control is used to activate AEDIT-86 in a noninteractive mode, usually 
from a command file. When BATCH is in effect, AEDIT-86 suppresses all output 
exceirt the MESSAGE line. 

Although AEDIT-86 may receive input from the console in BATCH mode (implying 
a semi-batch mode where input is from the keyboard), this is not recommended. For 
example, in this mode yes/no questions (e.g., *'c* to replace?") are suppre^ed; 
howew, AEDrr*S# gtill waits for the answers. 

Activation with BATCH Control 

If AEDIT-86 is invoked from a command file, all input is from the command file. 
The sequence of commands and characters should be exactly the same as if you were 
executing AEDIT-86 interactively. Input is echoed to the system console. 

Example 1. If you want to change dog tiA em throughout your file, you can create 
the following command file: 

AEDI T EXAMPL .SRC BATCH 
/Rdog<ESC>cat<ESC>QE 

where 

EXAMPL.SRC is the input file. 

/R means replace all occurrences. 

QE is the QUIT Exit command. 

< ESC > is inserted in the command file using the HEX Input command or using 
the < HEX > ftt*6tiifi key under INSERT. 

Example 2 . The text in example 1 was entered on one line because < cr > and < If > 

are read as part of the command input sequence. <cr> is a legal command but 

< If > is not and generates an error message. 

To avoid this problem, an AEDIT-86 macro file may be created, e.g., 
EXAMPL.MAC. This macro file disables the character pair < cr > < If > with the 
configuration command AFIG. The configuration command AFIG sets characters to 
be ignored (configuration commands are described in Chapter 9). In this case, you 
would set AFIG=ODOA. 
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In this example, the following command file may be used: 



AEDIT EXAMPL.SRC BATCH 



MGEXAI1PL.MAC<ESC> 
/Rdog<ESC>cat <ESC> 
QE 

where 

EXAMPL.SRC is the input file. 

MG is the MACRO Get command. 

EXAMPL.MAC is the macro file containing the configuration command 



Example 3. If all operations are defined in a macro (creating macro files is described 
in Chapter 5), the command file requires only two AEDIT-86 commands. In this 
example, given a macro with the required operation sequence called PASSl and a 
macro file called PASS I. MAC, the command file is as follows: 



AF1G = 0D0A. 



/R 
QE 



means replace all occurrences, 
is the QUIT Exit command. 



AEDIT EXAMPL.SRC BATCH 
MGPASS1.MAC<ESC>EPASS1<ESC> 



where 



EXAMPLE.SRC is the input file. 

MG is the MACRO Get command. 

PASSl. MAC is the macro file. 

E is the EXECUTE command. 



PASSl is the file containing the operation sequence. 
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4.3 Various BATCH Modes 

The BATCH control can be either BATCH or NOBATCH. NOBATCH is the 
default. The activation source can be either the keyboard or a command file. 

NOBATCH with input from the keyboard is the usual interactive mode. BATCH 

with input from a submit file is the usual batch operation. The remaining combina- 
tions, NOBATCH with input from a submit file and BATCH with input from the 
keyboard, are seldom used. 



4.4 Banner 

When AEDlT-86 is invoked, it reads and processes the macro file (if any), reads the 
input file (if any), clears the screen, and enters main command level. If an error is 
detected, an error message is displayed on the message line. Otherwise, the following 
banner is displayed: 

system-id A E D I T Vx.y Copyright yyyy Intel Corp. 

where: 

— is the busy/waiting indicator. 

system-id is supplied by the operating system. 

x.y is the AEDIT-86 version number. 

yyyy is the copyright year(s). 

4.5 Workmes 

The file :WORK: is used by AEDIT-86 as a predefined filename. AEDIT-86 assumes 
that any I/O operation to this file will be successful. It is your responsibility to make 
sure that :WORK: is available. System specific information on :WORK: is given in 
the appendixes. 
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Part II describes the more advanced uses of AEDIT'86. In this part, the macro 

commands and macro files, AEDIT-86 variables, the CALC command, advanced 
usage of AEDIT-86, and configuration commands are explained in detail. 

Chapter 5, "Macro Commands," discusses the manipulation of macros and how to 
create and use them. Maqros, sequences of cowajais that have been collected and 
given a name, are typically used for command sequences that are executed often. 

Chapter 6, "AEDIT-86 Variables," describes the set of local and global variables 
that you can access. 

Chapter 7, "CALC Command," describes the CALC command's capabilities. A 
CALC command expression can include l^eal operators, relational operators, shift/ 
rotate operators, and arithmetic operators. 

Chapter 8, "Advanced AEDIT-86 Usa^i" describes writing macros that incorporate 
the CALC command and AEDIT-86 variables. 



Chapter 9, "Configuration Commands," gives the characteristics and configuration 
commands for the Series III and Series IV systems and the DEC VTIOO family of 
terminals. 



CHAPTER 5 
MACRO COMMANDS 



AEDIT-86 macros are se(|lieflK^s of AEDIT-86 coiBMiiii^ (s^uences of keystrokes) 
that have been coIleGted and given a name. 

Macros are typically used for frequently executed command sequences. Instead of 
entering a series of commands, you can call a previously created macro to execute a 
command sequence automatically. Macros speed your work and reduce the typing 
errors associated with long ooinmand sequences. 

A set of macros may be grouped in a macro file. When you "get" such a macro file, 
all macros in that fUe are available for execution. 

Macro files contain macro definitions and may contain configuration commands, SET 
commands, and comments. 

AEDIT-86 enables you to create macros interactively u^a$ the MACRO Create 
command or directly using the My^CRQ. Insprt coipaa«a4. Typically, macros are 
defined interactively using MAQRO Createv^O*^ corrected or changed using MACRO 
Insert. 

r 

Macros are stored ia macro form. When yon create a macro, letters and digits are 
entered as is. Function keys are stored in a special format; for example, the AEDIT- 
86 command < DELR > is stored in its macro form, in this case, \XA. (Control 
codes are listed later in this chapter.) 



5.1 MACRO Command 

The MACRO csmmand is invoked by pressing M, which allows you to manipulate 
macros. 

A Macro definition is a series of commands written in macro form. Macros can be 
defined in two ways: interactively, by using the MACRO Create command, or directly, 
by writing macros to your macro file using the MACRO Insert command, which 
inserts text in macro form automatically. To save interactively defined macros, you 
must write them to a separate macro file in macro form. The MACRO Get command 
is used to get a macro file, thus making the macros it contains available for execution. 



5.1.1 Description 

Press M; AEDIT-86 prompts— 

Create G(<t Insert List Save 

To specify a subcommand, press the initial letter of that subcommand. 

Create 

The Create subcommand "creates" a macro interactively by accumulating a sequence 
of keystrokes. The macro is executed and created concurrently. 
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Pi^ C; AEDIT-86 ptM^s— 

<HOME> to re-edit 

Macro name: 



The name of the last macro specified for MACRO Create, MACRO Save or 
EXECUTE (if any) is displayed to the right of the colon. Type in the macro name 
followed by < ESC > or < RETURN > . 

A macro name can consists of either a single character or a character string of up to 
60 characters. The macro name may contain any characters, e.g., + , 6, a. 

After you type the macro name, the word "Macro" is displayed on the message line 
and remains there until the macro definition is complete. Then AEDIT-86 returns to 
main command level, and the entire set of AEDIT-86 commands is now available for 
MACRO Create. 



All subsequent keystrokes are executed in the regular manner, but they are also 
"remembered" or "trapped" by the editor. These keystrokes constitute the macro 
definition, including special keys like < ESC > and < HEX > , which behave as usual 
for the current activation; however, they are also inserted into the macro definition. 
The macro is terminated by typing one of the following characters: 

< CTRL-C > Terminates MACRO mode without defining the macro; 

the macro is deleted. 



M (main level only) 



Successful termination of macro definition. 



By defining a single-character macro, you are able to configure keys (see the 
EXECUTE command later in this chapter). 

Following is an example that interactively creates the macro dot (.) that finds the 
next occurrence of the last target string: 



g(ACRO) g(reate)_ 
Macro name: 



. < E S Oi 



F < E S C> M 



Following is an example that interactively creates a macro to configure < CTRL-L > 
to mean "jump to start of line." 

g|(ACRO) 0(reate) 

Macro name 



< C T R L - L > < E 
HTxLEFT) <HOME >M 



Error, "no more room for macros" is displayed on the message line, if macros exceed 
the amount of memory allocated to macros. In effect, the definition is terminated, 
and the current incomplete macro definition is deleted. 



Get 



The Get subcommand gets a macro file. This means that — 

• The macro definitions in the file are available for execution. 

• The configuration commands in the file are executed. 

• The SET commands in the file are executed. 

• The macro comment in the file are ignored. 
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Macro files are described later in this chafter. 

The new macro defiattions are added to tile current set of available macros. If a 

macro in the new set has the same name as a macro already available, the new macro 
overrides the previous one. Configuration commands and SET commands are executed. 

Press G; AEDlT-86 prompts — 

<HOME> to re-edit 

Macro file: 

The name of the last macro file read (if any) is displayed to the right of the colon. 
Edit the macro filcmmfi, if required, then press < RETURN > . 

You may insert an empty string as a filename by typing M(ACRO) 
G(et) < RETURN > to instruct AEDIT-86 to "get" the present text buffer as a macro 
file. 

When AEDIT-86 is invoked, the editor processes the initial macro file; The name of 
this file is taken from the macro control or, if this control is not specified, AEDIT- 
86 changes the invocation file extension to < root> .MAC and processes it automat- 
ically. This means that you do not have to get the default macro file to execute the 
macros in it. However, you must get any other macro file before its macros are avail- 
able for execution. 

Error . Any of the errors listed in Section B.4 may be issued during a MACRO Get. 
The error is displayed, the area causing the error is skii^)ed, and proofing continues. 

Related Conrauuids . The invocation controls MACRO, MACROSIZE 
Insert 

The Insert subcommand causes all subsequent input, including function keys (e.g., 
< ESC > < RUBOUT > ) to be insra'ted in the text in macro form and not executed. 
It is used to change and correct macro files. For example, if you press < UP > in 
MACRO Insert, the character sequence \CU is inserted in the text. The macro 
definition may then be saved in a macro file. This command is terminated only by 
typing <CTRL-C>. 

Press I; AEDIT-86 prompts — 

Control C to stop 

In MACRO Insert, all keys are entered as is (e.g., F(IND) is entered as F). Thus, 
keys such as < HEX > or < ESC > do not perform a function but are inserted as 
their macro codes. The following are ^c^^ioas: 

• When < RETURN > is typed, it is not converted to \NL because the carriage 
return is used to break macro definitions into more readable lines. Therefore, you 
must type \NL if < RETURN > is r^uired in the definition. 

• If the backslash is not a lead-ill cfatniCter, it must be entered twice (\ \). However, 
the backslash is not doubled when it is typed, which enables you to type \MM 
to temAsMe ^ macro or \NLfor < RETURN >. 

Type < CTRL-C » to tenninate MACRO Insert mode. 

laoMiple. The following mam) iefmea « CTRL-L > to mean jump to start of line. 
(Remember that what you type does not execute but is inserted in macro form.) 



f 1 Jename 



B(ACRO) ^nsert)^^Q|^n^Q^^^^Q^^^^QQg^y^^^^^^^Q(end macro) 

|(UIT) |(pdate) or KUTT) B(xit) 
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The following text is inserted into filename: 
M\OOC\BR\CR\CL\CH\MM 

MM terminates the macro definition (see also Section 5.3, "Macro Modes"). 
List 

The List subcommand displays on the message line the names of all currently avail- 
able macros. If there are more macros available than can be listed on the message 
line, the message "hit space to continue" is displayed. Press the space bar to continue; 
any other character returns the editor to main command level. 

Save 

The Save subcommand translates an available macro to macro form and inserts the 
definition at the current position in the text. The macro may subsequently be modified 

or saved in a macro file. If you want to look at a macro definition, use MACRO Save 
to translate and display the macro, review it, and delete it (if desired). 

Press S; AEDIT-86 prompts — 

<HOME> to re-edit 

Macro name: 

The name of the last macro specified (for MACRO Create, MACRO Save or 
EXECUTE) is displayed to the right of the colon. Type a macro name followed by 
< ESC > or < RETURN > . If the macro exists, it is inserted in the text at the current 
cursor location in macro form. 

You may use the following procedure to save a new, interactively created macro for 
future use: 

1 . Press O to enter the OTHER buffer. 

2. Use the QUIT Init command to invoke your macro file. 

3. Specify the macro filename when prompted. 

4. Insert the macro in macro form using the MACRO Save command. 

5. Update the modified macro file using the QUIT Update or QUIT Exit command. 



5.2 Deleting Macros 

To delete a macro from the set of available macros, use the MACRO Create 
command. Type the following: 

|(ACRO) B(reate)^^^^^BBS^^^^2BgB 

where 

macro^name is the name of the macro to be deleted. 

This procedure does not delete a macro from a macro file. To delete from a macro 
file, you should edit the macro file like any other file, and use the delete commands. 
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5.3 Macro Modes 

A macro may be either modeless (terminated with \MM after it is converted to 
macro form) or non-modeless (terminated with \EM after it is cooverted to macro 
form). All macros created with MACRO Create are modeless. A non-modeless macro 
may be created using MACRO Insert or by editing a saved modeless macro. 

Any modeless or non-modeless macro may be used at main command level or in 
either INSERT or XCHANGE modes. 

A modeless macro is independent of whether it is called from main command level, 
INSERT or XCHANGE mode. This allows \ou to use the same macro at the main 
command level and in INSERT or XCHANGE mode. When you execute a modeless 
macro, it executes as if it is at main command level. When it Unishes execution, it 
restores the mode (e.g., XCHANGE) that was in effect when it was activated. 

A non-modeless macro is executed at the AEDIT-86 prompt level that was in effect 
when the macro was activated. When the macro finishes execution, it does not restore 
the mode that was ia effect when it was assEtotei. teteadv AEDIT-86 remains in the 
mode determined by the macro. Non-modeless macros provide compatibility and 
upgrading with respect to AEDIT Vl.O. 

Modeless macro execution alw^s, give th^ same results regardless of the mode from 
which it was executed. Noh-iiiibdete#s mdefd execution results usually depend on the 

context (mode) from which they were called. It is recommended that you use modeless 

macros whenever possible. 

For example, compare the following macros: 

MA\BRi*\BR\MM 
MB\BRi*\BR\EM 

The first macro is modeless. When it is executed, the character * is inserted whether 
or not it was called from fflaitt command level, INSERT, or XCHANGE mode; when 
the macro finishes, the initial mode is fetawd. 

The second macro is non-modeless. If it is called from main command level, the results 
are the same as for the first; i.e., the character * is inserted and the editor remains at 
main command level. But, if the second macro is called from INSERT mode, for 
example, the characters i* are inserted into the text, and the < ESC > command 
( \ BR) causes the editor to leave INSERT mode and return to main command level. 



5.4 EXECUTE Command 

The EXECUTE command requests a macro name and executes the specified macro. 

In macro execution all input is taken from the macro except for answers to the 

following questions/requests: 

• ?Replace: "ok to replace?" 

• QUIT Init or QUIT Abort: "all changes lost?" 

• BLOCK Delete: "cannot save in memory, save anyway?" 

• "hit space to continue" 

• QUIT Write or BLOCK Put: "overwrite existing file?" 

In the prompts listed above, the response to the prompt is taken from the console. 
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5.4.1 Description 

Press [count] E; AEDIT-86 prompts — 

<HOME> to re-edit 

Macro name: 

The name of the last macro specified (for MACRO Create, MACRO Save, or 
EXECUTE) is displayed to the right of the colon. Type a macro name followed by 
< ESC > or < RETURN > . If the macro exists, it is executed. 

If the busy/waiting indicator is active, the prompt line displays -!!- when a macro is 
being executed. This is important in single-character macro execution where there 

may not be any other indication that a macro is still executing. 

The macro terminates when it has been executed the specified number of times or 
failed. Section 5.8 describes macro execution termination in more detail. 

Macro activation may be nested up to eight levels. 

Type a < CTRL-C > to force termination of macro execution. 

Errors 

• "no such macro" is displayed if the macro specified does not exist. 

• "macro nesting too deep" is displayed if you attettpt to nest macros to more than 

eight levels. 

Count. The EXECUTE command accepts any count. 
Related Commands . SET Display, SET Go 

5.5 Macros and AEDIT-86 Variables 

When AEDIT-86 variables are referenced during MACRO Create, the actual varia- 
ble value is fetched for the current activation of the macro, and a reference to this 
variable is inserted into the macro definition. The use of AEDIT-86 variables provides 
a primitive way to simulate passing a parameter to a macro. See Section 6.3 for more 
details. 



5.6 Single-Character Macros 

You can write macros with single-character names. You can activate a single- 
character macro by simply typing its name if this character has no other function in 
the context from which it is being activated. Single-characters that can be used as 
macro names are referred to as "free" characters, e.g., L, U, Z, +, !. 

Single-character macros can be activated in the following ways: 

• Using the EXECUTE command at main command level (as in the case for all 
macros). 

• By pressing the macro character preceded by the < MEXEC > key. 

• By pressing the key itself, if the key is "free," that is — 

In INSERT and XCHANGE modes: all nonconfigured control characters. The 
following control characters also cannot be used as macros in this way: 
< CTRL-M > ( < RETURN > ), < CTRL-I > ( < TAB > ), and < CTRL-J > 
(line feed). 

In main command levels: the same as for INSERT and XCHANGE modes with 
the addition of all printable characters that are not used as AEDIT-86 commands 
(e.g., +, $, U, etc.). 
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< MEXEC > is a configurable key (usually < CTRL-E > ). To activate the single- 
character macro, press < MEXEC > followed by the macro name. For example, if 
you are using the macros from USlPtJL.MAC in INSERT mode, typing 

< MEXEC > t converts the word that starts "under" the cursor to uppercase letters. 

A digit may not be used as a single-character macro at main command level because 
it is always interpreted as a count. A function key may not be used as a macro name 
because the key's function overrides tfie M0t^ i^finition. 

The following is an example to demonstrate using a single-character macro in 
INSERT or XCHANGE mode. You can define a macro called < CTRL-P > as the 
word PROCEDURE and save this macro in a file called PLM.MAC. If you are 
editing a PL/M source file, ym can' call PLM.MAC with MACRO Get; then, each 
time you type < CTRL-P > the word PROCEDURE will be inserted into the file. 
This saves having to type out the word each time you want to insert it. 



• "illegal command" is displayed when y<m type a character that is not a command 
abbreviation, a decimal digit, or a macro name, at main command level. 

• "no such macro" is displayed if the character following the EXECUTE command 
or the < MEXEC > key is not a macro name; i.e., no macro with that name 
exists. 



5.7 Macro Files 

A macro file may consist of the following: 

• Configuration commands 

• SET commands 

• Macro definitions 

• Macro comments 

Configuration commands specify the host/terminal characteristics (described in 
Chapter 9). 

SET commands are the only commands, with the exception of configuration 
commands, that can be specified in a macro file. Including SET commands allows 
you to specify the mode of operation. For example, if you use a macro called 
AEDIT.MAC to "set" your environment, you may include the command SET 
K_token Yes if you want the enviromnettt initialized to search for tokens only. In the 
macro file, this conmiand appears as SKY. 

A macro definition is a series of commands written in macro form. It has the follow- 
ing format: 

M macro jname \ B R charactarsjnummsro \ M n 



Errors 



where 



charactersJn_macro 
\MM 
\EM 



M 



macro_name 



\BR 



declares that a macro definition follows. 

is any name given to the macro being defined. 

stands for < ESC > . 

is the macro contents. 

signals the of a QiQ#eI^ macro. 

signals the end of a non-modeless macro. 



5-7 



AEDrT.86 User's Gnide 



The following representations of control characters and control codes are used in the 
macro definitions. 



Name 


Represents 


\BR 


<ESC> 


\CL 


< LEFT > 


\CR 


< RIGHT > 


\CU 


<UP> 


\CD 


< DOWN > 


\CH 


<HOME> 


\NL 


< RETURN > 


\RB 


<RUBOUT> 


\TB 


<TAB> 


\XF 


< DELCH > Delete Character 


\XX 


< DELL > Delete Left 


\XA 


< DELR > Delete Right 


\XZ 


< DELLl > Delete Line 


\XU 


<UNDO> 


\XH 


< HEX > Hex prefix character 


\XE 


<MEXEC> Macro Execute 


\XN 


< FETN > Fetch Numeric 


\XS 


< FETS > Fetch String 


\0h 


Hexadecimal value of a character 


\MM 


End of modeless macro definition 


\EM 


End of non-modeless macro definition 



The blackslash ( \ ) must appear twice if it is not used as a code lead. 

A macro definition and configuration commands should be ended with either a 
semicolon (;) or <cr>. <cr> and < If > (as opposed to \NL and \0A) are ignored 
in a macro file, even within macro definitions. This allows you to split the macro 
definition into lines so that it is easier to read. 

Comments may be included in a macro file. A comment starts with a backslash/ 
asterisk character pair ( \ *) and ends with an asterisk/backslash pair (* \ ). All 
characters, including carriage return and line feed, may appear in the comment. The 
following is an example of a comment: 

\* this Is a comment *\ 



5.8 Macro Execution after a Failure 

A command execution is marked as failed if — 

• An attempt is made to move forward ( < RIGHT > , < DOWN > , < HOME > , 
or < RETURN > ) at the end of the file. 

• An attempt is made to move backward ( < LEFT > , < UP > , or < HOME > ) at 

the start of the file. 

• A (-)FIND or (?)REPLACE command fails to find the target string. 

A command prefixed by a finite count is marked as failed if any of its execution is 
thus marked. 

A (-)FIND or (?)REPLACE command prefixed by / is marked as failed only if it 
fails ofl its first execution. 
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A (;ursor movement command prefixed by / is never marked as failed. 

If the SET Go option is on, the (-)FIND and (?)REPLACE commands are never 
majrked failed. 

When a command in a macro is marked as failed, the following occurs: Macro execu- 
tion is terminated, and control is returned to the caller. If the caller is main command 
level, AEDIT-86 simply waits for the next command. If the caller itself is a macro, 
execution continues with the caller's next command. 

Example 

Macro A: /E(XECUTE) B 
E(XECUTE) C 
E(XECUTE) D 

Micro B: J(UMP) S(tart) 

/R(EPLACE) " < nl > < nl > " with " < nl > " 



M^cro C: S(ET) G(o) Y(es) 
J(UMP) S(tart) 

/R(EPLACE) "DCL" with "DECLARE" 
J(UMP) S(tart) 

/R(EPLACE) "IS" with "LITERALLY" 

• A value for SET Go in macro A is meaningless, because it does not contain a 
(-)FIND or (?)REPLACE command. When /EXECUTE B is terminated either 
normally or because macro B failed, macro C is executed. Likewise, when macro 

C is terminated, macro D is executed. 

• SET Go must be set to No (the default) for macro B. The REPLACE command 
is successful as long as the file contains at least one < nl > < nl > sequence. When 
the file contains no < nl > < nl > sequences, macro B fails, execution of macro B 
is terminated, and macro C is executed. If SET Go is Yes for macro B, it will 
never fail, and execution of macro B would enter an infinite loop. 

• SET Go must be set to Yes for macro C. This option ensures that the second 
REPLACE command is performed regardless of the results of the first REPLACE 
command. S(ET) G(o) Y(es) could be placed after the JUMP command, and 
the effect would be the same. 

If you are not careful in coding your macro, it might enter an infinite loop when it 
executes. To exit from such a macro or to terminate any macro, press < CTRL-C > . 



5|9 Screen Display during IMacro Execution 

To speed up macro execution, the amount of data written to the screen while a macro 
is executing is reduced to a minimum. Only selected text or information is sent to the 
screen. The information in this section is given for rs£^:e^. 



5.^.1 Text 

If SET Display No (the default) is in effect, changes in the text and cursor movements 
are displayed on the screen as long as the cursor does not leave the current display 
screen, or until a VIEW command (either explicit or implicit) is issued. When the 
cursor leaves the screen or a VIEW command is issued, screen display is frozen until 
the macro execution terminates. Then, an implicit VIEW command is performed 
using the current logical cursor location. 
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If SET Display Yes is in effect, all changes and cursor movements are displayed on 
the screen, even if the cursor leaves the screen or a VIEW command is given. 

Regardless of the SET Display value, the text is updated if you give the 7REPLACE 
command or the FIND/REPLACE command and SET Showfind Yes is in effect. 



5,9.2 Message 

The message line is updated only in the following cases: 

• Error message display. The error message display lasts for about a second. The 
FIND/REPLACE command message "not found" is not considered an error. 

• CALC command messages. For an argument that is an expression rather than 
an assignment statement (e.g., N3 + 1 versus N2 = N3 + 1 or S9 versus 

S9 = "abc"). 

• HEX Output and MACRO List command messages. 

• QUIT or OTHER command filename messages. 

The above set is carefully chosen to contain the cases where either the message is 
important or the command affects the message line only. 

When macro execution is terminated, the last message remains on the screen. 
However, the status (e.g.. Other, ¥iewoflly) is updated if needed. 

The "found: count" message is a special case; it is displayed only if it is the last 
m^sage of the macro execution at main command level. 



5.9.3 Prompt 

The prompt line is changed only when a macro requests an answer to one of the 
questions listed in Section 5.4. 

After macro execution terminates, the prompt line reflects the current mode of the 
editor. This mode is either main command level, or INSERT or XCHANGE mode. 



5.9.4 Window 

When a new window is constructed, the text is updated immediately, which is an 
exception to the previous description. The reason for this exception is to create a 
place for a future message that may refer to the upper window. The KILL_WND 
command operates in the usual manner. That is, when the cursor leaves the screen, 
the screen will be updated only v^hen macro execution terminates. 



5,10 Macro Exantples 
5.10.1 Example 1 

It is often necessary to reset the left column. The single-character macro right square 
bracket (]) sets the left column one position to the right each time it is executed, and 
the single-character macro left squarebracket ([) sets the left column one position to 
the left each time it is executed: 

M] \BRSL+1 \NL\MM 
M[ \BRSL-1 \NLVMM 
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These macros can be defined interactively using the MACRO Create command. For 
example, the first macro can be created by entering the following commands: 



0(ACRO) flCreate) 



11 o 

I 



ET) fl(eftcol 

(to terminate macro definition 



< E S C > 
RETURN 



I 



Aft^r you define these macros, typing a right square bracket (]) at main command 
level or < MEXEC > ] in INSERT or XCHANGE mode sets Leftcol one position to 
the right of its current setting; typing a left square bracket (]) at main command 
level or < MEXEC > [ in INSERT or XCHANGE mode sets Leftcol one position to 
the left of its current setting. 



5.10.2 Example 2 

The following single-character macros, named dot (.) and comma (,) find the next 
occurrence of the target string, or find the previous occurrence of the target string, 
respectively. 



M 
M 



\BRf \BR\MM 
\BR- \BR VMM 



These macros can be defined interactively using the MACRO Create command. For 
example, the first macro could be created as follows: 

0(ACRO) H(reate ) 

Macro name ; ^^^^^Q 

(1o termmate the macro definition) 

After you define these macros, typing a dot (.) at main command level or 
< MEXEC > followed by a dot in INSERT or XCHANGE modes finds the next 
occiirrence of the target string; typing a comma (,) at main command or < MEXEC > 
followed by a comma in INSERT or XCHANGE modes, finds the previous occur- 
rence of the target string. 



5.10.3 Example 3 

It is often desirable to use visual breakpoints in programs. For example, you can use 
comment lines filled with hyphens to separate procedures in a language. The follow- 
ing macro creates a break line: 

M@ \ BRI(* *) \ NL \ BR \ MM 

You can create this macro interactively with the following commands: 



H(ACRO) B(reate)_ 
Macro name: 



< R E T U R N > 



After you define this macro, typing @ at main command level, or < MEXEC > (s in 
INSERT or XCHANGE mode inserts the break line at the current cursor position 
in text. 



5-11 



Macro ( item^ds 



&.10.4 Example 4 



The following sequence of commands saves, in a new file named EXMPL.MAC, an 
interactively defined macro named asterisk (*) that allows you to scroll backwards 

ten lines. 



|3(ACRO) Q( reate) 
Macro name: 



* < R E T U R N > 



< U P > M 



0(THER) 
0(UIT)|J(nit) 
B|(ACRO) @(ave) 



EXMPL.MAC<RETURN> 



llacro name 



(UIT) nkpdate) 



<RETURN> 



Create macro * interactively 



Command sequence 



Invoke the MACRO Save command, 
which prompts for the macro name 

Execute the MACRO Save command, 
translate the macro * to macro form. 

Update the macro file 
(EXMPL.MAC), which flow includes 
the macro *. 
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CHAPTER 6 
AEDIT-86 VARIABLES 



AEDIT-86 has a set of variables that can be accessed by the user. This set has the 

following characteristics: string variables versus numeric variables, read-only varia- 
bles versus read-write variables, local variables versus global variables. 

• Read-only variables reflect internal AEDIT-86 values that you can retrieve but 
not modify. Read-write variables can be modified freely. Read-write variable 
assignment can be done only in the CALC command. 

• Local variables can be accessed only in the CALC command. Global variables 
can be accessed in other contexts as well. 




e.^l Global Variables 

The two types of global variables are numeric and string. The global numeric varia- 
bles! are all read-write. The global string vadables can be read-oflly or read-write. 



6.1.1 Global Numeric Variables 

The ten global numeric read-write variables (N-variables), are N0-N9, which are 
32-bit numbers. Values are assigned to the N-variables only in the CALC command. 
To fetch an N-variable, type < FETN > /, where < FETN > is the "fetch numeric" 
key (usually configured to < CTRL-N > ), and / is any digit from 0-9. When AEDIT- 
86 is invoked, the N-variables are initialized to zero. 

The N-variables may be used in the following ways: 

• j In any line-edit prompt, e.g., target-string, replacement-string, or GET filename. 

The contents are inserted and displayed as signed decimal numbers; leading zeros 
are suppressed. The conversion is carried out by the line-editing mechanism, 
regardless of the command currently being executed. 

Note that a confusing case occurs when the hexadecimal value of a variable is 
interpreted as a decimal value. For example, if Nl contains the hexadecimal 
value 2DH, which is equivalent to 45 decimal and you type < FETN > 1 under 
HEX Input, the character E (45H ASCII) is inserted into the text. 

• As a count (or part of a count) for a command. Count cannot be negative; there- 
fore, the absolute value of the N-variable is used. In this case, the value of the 
N-variable should be in the legal range, 0-65535. The contents are displayed as 
an unsigned decimal number; leading zeros are suppressed. 

• In INSERT and XCHANGE modes. For example, if < FETN > 1 is typed, the 

contents of Nl are inserted in the text in a form that depends on the value of 
SET Radix. For example, if variable Nl contains the hexadecimal value 45H, 
then — 

IF SET Radix is alpha: E 

IF SET Radix is binary: 1000101 

IF SET Radix is decimal: 69 

IF SET Radix is hex: 45 

IF SET Radix is octal: 105 

The value is inserted without a suffix wad leading zeros are suppressed. 
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• Under the CALC command. The variable may be retrieved as in any line-edit 
prompt. Also, the variable name may be used as is, e.g., Nl instead of 
< FETN > 1. In this case the name, rather than the value, is displayed, e.g., Nl 
instead of 45. The entire processing is done by the CALC command, not by the 
line-editing mechanism. A variable may be modified only if it appears in CALC 
with its name on the left-hand side of an assignment statement. 

When the < FETN > key is pressed, the message < FETN > appears on the 
message line. This message disappears when the next key is pressed. 



6.1.2 Global String Variables 

The two groups of global string-variables (S-variables) are — 

• Read-write string variables 

• Read-only string variables 

Read-Write String Vwiables 

The ten read-write variables are S0-S9. Value assignment is done only in the CALC 
command. When AEDIT-86 is invoked, these variables are initialized to a null string. 

Readonly String Variables 

The following is an alphabetic list of the read-only variables. No assignment of values 
is allowed. 



SB Up to 60 characters of the Block buffer. By using SB, a portion of the 

text file may be used later as, for example, an argument in a FIND 
command. 

SB The name of the current edited file (as opposed to the secondary file). 

SG The name of the last file specified in the GET command. 

SI The name of the main input file. 

SM The name of the last file specified for the MACRO Get command. 

SO The name of the OTHER input file. 

SP The name of the last file specified for the BLOCK Put command. 

SR The replacement string of (?)REPLACE. 

ST The target string of (-)FIND and (?)REPLACE. 

SW The name of tbe last file specifliul in the QUIT Write command. 



Using String Variables 

To fetch the value of a string variable, type < FETS > x, < FETS > is the "fetch 
string" key (usually configured to < CTRL-S > ), and where x is a digit (0-9) or a 

letter appearing as the second letter in a name in the above list (e.g., B, E, G). For 
example, < FETS > 7 fetches the value of 57, and < FETS > G fetches the value of 
SG. An S-variable contains a string of 0-60 characters. 
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Th^ S-variables may be used in the following cireumstances: 

• In any line-edit prompt, e.g., target-string, replacement-string, GET filename. The 
contents are inserted and displayed as an ASCII string. The conversion from 

< FETS > X to the ASCII string is done by the line-editing mechanism, regard- 
less of which command is currently being executed. 

• In INSERT and XCHANGE modes. For example, if < FETS > 1 is typed, the 
contents of SI are inserted in the text. 

Note that a character that is inserted in this way loses any special meaning it 
may otherwise have. For example, ODH is inserted as is and not as a carriage 
return, or OIBH ( < ESC > ) does not cause mode termination. 

• Under the CALC command. The S-variable may be retrieved as with any line- 
edit prompt. Also, the S-variable name may be used as is, e.g., SB instead of 

< FETS > B. In this case, the name rather than the value is displayed, e.g., SM 
rather than AEDIT.MAC. All processing is done by the CALC command and 
not by the line-editing mechanism. An S-variable may be modified only if it 
appears in CALC with its name on the left side of an assignment statement. 

An S-variable is always considered as if all its characters are literalized; i.e., they are 
interpreted as regular characters even if in other cases they may have a special 
meaning, e.g., < HEX > . Thus an S variable is never searched to determine if it 
fetches another S variable. However, in any other legal context, input is expanded if 
it includes a fetch operation of the form < FETS > x. 

When the < FETS > key is pressed, the message < FETS > appears on the message 
line. This message disappears when the next key is pressed. 



6.2 Local Variables 

All local variables are read-only numeric variables. Therefore, they cannot be assigned, 
and they can be used only in the CALC command. 

The following is an alphabetic list of positional values: 

EOF Logical value — ^true if the cursor is at the beginning of file. 

COL The current logical cursor position in the line. (This value is not affected 

by the setting of LeftcoL) 

CURCH ASCII value of the current character. 

CURWD ASCII value of the two bytes at the current cursor location. 

EQF Logical value — true if the cursor is at the end of file. 

INOTHR Logical value— true, if you are in the OTHER buffer. 

ISDEL Logical value — true if the character at the current position is in the 
user defined delimiter set. 

ISWHTE Logical value — true if the character at the current position is a white 
space (space, tab, LF or CR). 

LOWCH If the current character is an uppercase character (41 H to 5AH), 
LOWCH is the ASCII value of the lowercase character. Otherwise, 
LOWCH is the same as CURCH. 
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NXTCH 



ASCII value of the next character. 



NXTJAB The column number of the next (i.e., to the right of the cursor) tab 

position as defined by SET Tab. If there are no tabs to the right of the 
cursor in the current line, the value of NXTTAB is zero. 

NXTWD ASCII value of the second and third bytes following the current cursor 
location. 

ROW Current cursor row (actual row, not the logical line in the text). 

UPCH If the current character is a lowercase character (61 H to 7AH), UPCH 

is the ASCII value of the uppercase character. Otherwise, UPCH is 
the same as CURCH. 

The following values are offset from the beginning of the currently processed input 
file. Note that these variables count the carriage return /line feed pair as two charac- 
ters, whereas AEDIT-86 usually counts the carriage return/line feed pair as one 
character. If the file is edited using the FORWARDONLY control, the offset is from 
the current beginning of text. This position may vary as the cursor is moved forward. 

CURPOS Offset of current location in file. CURPOS is zero for the first charac- 
ter of the file. 



TAGA 
TAGB 
TAGC 
TAGD 



Offset of tag A. 
Offset of tag B. 
Offset of tag C. 

Offset of tag D. 



The following values relate to the S^variables: 

SL0-SL9 Relates to the S-variables S0-S9. Each variable contains the length of 
the corresponding global read-write S-variable. 

SLx Relates to the S-variables, Sx, where x is the second letter in one of the 

global read-only variable names (e.g., B, E, G). Each variable contains 
the length of the corresponding global read-only S-variable. 

The following is an alphabetic list of counters that contain the actual number of 
command repetitions from the last time the command was specified with count greater 
than one. The CNT prefix signifies COUNT. 

CNTEXE The number of times the macro that is currently executing has executed 
in the current activation. The first execution is number one. If none, 
the value is zero. 



CNTFND Relates to (-)FIND. 

CNTMAC The number of times that the last macro (which has finished execut- 
ing) was executed. 

CNTREP Relates to ( ? )REPLACB. 
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The following -values relate to the margin and indentation settings used by 
PARAGRAPH and SET Autonl commands: 

IMARGN The value of current indent margin setting. 

LMARGN The vAie of eswent left margin setting. 

RMARGN The value of current right margin setting. 

The following values are returned by the UDI-call DQSGETSTIME: 

DAhrE Date returned by DQ$GET$TIME in decimal format mmddyy. 

TIME Time returned by DQSGETSTIME in decimal format hhmmss; note 

that some systems always return for the time function. 

The following are other valu^: 

LSTFND Logical value — true if the last find or replace string was found. (Note 
that an infinite FIND C,/F) sets this variable to TRUE if at least one 
FIND succeeded.) 

NSTLVL Nesting level of the currently executing macro, console input is level 0. 

I 

6.3 Usage and Interpretation of Global Variables in 
Macros 

When the value of any AEDIT-86 variable is fetched during MACRO Create, the 
actual value is used for the current activation. A reference to this variable is inserted 
into the macro definition. Therefore, in a future activation of the macro, the value of 
the variable at the time of macro activation will be used, not the value of the variable 
at the time of maero definittoh. 

For example, if you have the following macro: 

I(NSERT) <FETS>7<ESC> 

and S7 = "abc" at the time the macro was defined, abc is used for the current activa- 
tion. If the definition of S7 is changed to xyz and the above macro is again activated, 
xyz is inserted. 

6.4 Summary of ^^IT-86 Variables 

6.4. 1 Read-Only Variables 

The following is an alphabetic list of the read-only string variables. No assignment 
of values is allowed. 

SB Up to 60 characters of the Block buffer. 

SE The name of the current edited file. 

SG The name of the last file specified in the GET command. 

SI The mme (g Mm main input fUe. 
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SM 
SO 
SP 
SR 
ST 
SW 
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The niitn# of the last file specified for the MACRO Get command. 
The name of the OTHER input file. 

The name of the last file specified for the BLOCK Put command. 

The replacement string of (?)REPLACE. 

The target string of (-)FINP and (?)REPLACE. 

The name of the last file specified for the QUIT Write command. 



6.4.2 Local Variables 

AH local variables are read-only numeric variables. They cannot be assigned, and 
they can be used only in the CALC command. 

The following is an alphabetical list of positional values: 

BOF Logical value — true if the cursor is at the beginning of file. 

COL The current logical cursor position in the line. (This value is not affected 

by the setting of Leftcol.) 

CURCH ASCII value of the current character. 

CURWD ASCII value of the two bytes at the current cursor location. 

EOF Logical value — true if the cursor is at the end of file. 

INOTHR Logical value — ^true if jm are in the OTHER huffer. 

ISDEL Logical value — true if the chatteter at the earfent position is in the 
user defined delimiter set. 

ISWHTE Logical value — true if the character at the current position is a white 
space (space, tab, LF or CR). 

LOWCH If the current character is an uppercase character (41 H to 5AH), 
LOWCH is the ASCII value of the lowercase character. Otherwise, 
LOWCH is the same as CURCH. 

NXTCH ASCII value of the next character. 

NXTTAB The column number of the next (i.e., to the right of the cursor) tab 
position as defined by SET Tab. 

NXTWD ASCII value of the second and third bytes following the current cursor 
location. 

ROW The current cursor row (actual row, not the logical line in the text). 

UPCH If the current character is a lowercase character (61H to 7 AH), UPCH 

is the ASCII value of the uppercase character. Otherwise, UPCH is 
the same as CURCH. 
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The following valu^ are offset from the beginning of the currently processed input 
file: 

CURPOS The ^tet mmmA toc^tion in file. 

TAGA The offset of tig A. 

TAGB The offset of tag B. 

TAGC The offset of tag C. 

TAGD The offset of tag D, 

The following value»fdatetete H'^vaiteMes: 

SL0-SL9 Rekt«i to tte 'W-mM^ M-S9. 

SLx Relates to the S-variables, Sx, where x is a second letter of one of the 

global c^d-oofy mmlbie mmes (e.g., B, E, G). 

The following is an alphabetic list of counters that contain the actual number of 
command repetitions from the last time th@ ismmmi was specified with count greater 
than one: 

CNTEXE The number of times the macro that is currently executing has executed 
in the current ae^pr^&m. The first execution is number one. If none, 
the value is zero. 

CNTFND Relates to (.)FIND. 

CNTMAC The number of times that the last macro (which has flnished execut- 
ing) was exeeoleC 

CNTREP Relates to (DREPUim, 

The following values relate to the margin and indentation setting used by 
PARAGRAPH and SET AatQid^eotOMW^s: 

IMARGN The value of cttMit ^ident margin getting. 

LMARGN The valiae of ettflr^ left margin setting. 

RMARGN The value of current right margin setting. 

The following values are returned by the UDI-call DQ$GET$TIME: 

DATE Date in decimd t^emiSt mm&^. 

■TOiE Time in decimal format hhirmss; note that soms systems always return 
for the time function. 

The following are other values: 

LSTFND Lc^cid valtie — ^tflie if the last find or replace string was found. 

NSTLVL The nesting lercl the currently executing macro; console input is 
level zero. 
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CHAPTER 7 
CALC COMMAND 



The CALC command provides you with computation capabilities. These capabilities 
coupled with AEDIT-86 variables enable the following, for example: centering a 
phrase on a line, finding the size of an input file, or changing a letter from lowercase 
to uppercase or vice verisa. 

To execute the CALC command, press C; AEDIT-86 prompts — 

<HDME> to re-edit 

Ca 1 c : 

The last statement entered uate'CALC is (displayed to the right of the colon. 

7.1 Introduction 

Either a numeric or a string statement is legal input to a CALC command. In general, 
the statement is either an assignment statement or merely an expression. A CALC 
expression is comparable to expressions in many other programming languages. It 
includes logical operators, relational operators, shift/rotate operators, and arithmetic 
operators. As usual, an expression may include parentheses. These, plus the prece- 
:4sifk& and associativity rules of tfie i^wators, completely define the evaluation order. 

The operators act on the fdSowing elements: numeric constant (integers only), string 
constants, AEDIT-86 numeric local 't^anibl^, N-variables, and S-variables. 

Arithmetic using the CALC QcMnMi Ss 32-bit signed adthmetic. No overflow 
detection is performed. 

7.2 Syntax Diagrams for CALC Statement 

This section presents the CALC input syntax in syntax diagram form. In these 
diagrams, every path you can follow in the direction of the arrow represents a 
syntactically correct construct of CALC input. Terminal symbols of the language, 
keywords, letter symbols, and punctuation symbols that are typed verbatim as CALC 
input are enclosed in circles or ovals. Nonterminal symbols (terms standing for 
language constructs that are defined in their own syntax diagrams) are enclosed in 
rectangles. 



statement- 





n_statef¥ient 
















8_stateinent 









lustatwnent: 



CALC Coomuuid 



AEDIT-86 User's Guide 



H n-»tateinent *^ 



expression: 



I 



unary_operator 




ntniwriGL-constant 



AEDnLnumarlcJocaL.vartible 



s_staleinent: 




Notes: 

• n_statement, s_statenient : n stands for numeric, s stands for string. 

• Lelement, r_element : / stands for left, r stands for right. 

• Uppercase and lowercase letters are not distinguished from each other except in 
string constants. For example, curpos and CURPOS are interchangeable. 

• One or more blanks may be inserted between tokens. However, when no ambigu- 
ity is possible, blanks are not required. For example, 1 + 2 is a legal expression. 

• Ni, Sj, N(...), S(...) : the value of i and the value of the expression within the 

parentheses should be in the range 0-9. 

• The value true is represented by — 1; i.e., OFFFFFFFFH, and the value false is 
represented by 0. Whenever an operator produces a logical (Boolean) value, that 
value is either true or false. 

• unary_operator : see Table 7- 1 . 

• binary _operator : see Table 7-1. 

• AEDIT_numeric_local_variable : described in Chapter 6. 

• numeric_constant : see Section 7.3. 

• string_constant : see Section 7.4. 
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Table 7-1 . Operators' Precedence and Associativity 



Operator 
Class 




Intorpretatlon 


Associativity 


Parentheses 


( ) 


Controls evaluation 
order: expressions In 
parentheses are 
evaluated before the 
action of any outside 
operator on the items 
in parentheses 


From inside 
to outside 


Unary 


+ --•!# 


Single positive opera- 
tor, Single negative 
operator, 1 's comple- 
ment (- or ') 
POS operator (!) 
NEG operator (#) 


From right to 
left, e.g., 
!#3 is 
!(#3) 


Power 


** 


Raising to the power 
of 


From right to 
left, e.g., 
3 ** 4 ■• 5 is 
3 " (4 "5) 


Arithmetic 
(mul/div) 


* / \ 


Multiplication, division, 
mod (remainder) div 


From left to 
right, e.g., 
11 * 12 * 13 is 
(11 *12)*13 


Arithmetic 
(add/sub) 


+ - 


Addition, subtraction 


From left to 
right, e.g., 
2-3-1-4 is 
(2-3)-t-4 


Shift/rotate 


SHL,SHR,SAL,SAR,ROL,ROR 


Shift left, shift right, 
shift algebraic left, 
shift algebraic right, 
rotate left, rotate right. 


From left to 
right, e.g., 
5 SAR 1 SAR 
1 is 

(5 SAR 1) 
SAR1 


Relational 


< <= - - <> => > 


Less than, less than 
or equal to, equal to, 
not equal to, greater 
than or equal to, 
greater than 


From left to 
right, e.g., 
3 < 4 < 2 is 
(3 < 4) < 2 


Lx)gical 


& 1 A 

, ,1 


•jMII6,OR,XOR 


From left to 
right, e.g., 
5 & 3 A 7 is 
(5 & 3) A 7 



-1-1, .1 1 

7.3 Numeric Constants 

The CALC command numeric constants are integer numbers. They can be binary, 
octal, decimal, or hexadecimal. The CALC command recognizes these constants by 

the suffix B, O (or Q), D, or H, respectively. Numbers without a suffix are consid- 
ered decimal. A numeric constant may be in the range — (2**31) to +(2**31)— 1. 

7.4 String Censtanto 

A string constant may be 0-60 characters long with same delimiter at both ends. The 
same delimiter ta^m that there is no predefined string delimiter; rather, the charac- 
ter immediately to the left of the string con^laat n identified as a delimiter. Tbeit tlie 
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second occurrence of that character signifies the right end of the string. To prevent 
ambiguity, the following characters may not serve as string delimiters: letters, digits, 
blank, and tab. 

A natural delimiter choice is a quotation mark. However, if the string constant includes 
a quotation mark, a different character, one that do® not appear in the string, should 
be used as the delimiter. 

The case of the letters within the string is preserved. 



7.5 Operators 

Syntactically, operators are divided into two groups: unary operators and binary 
operators. From the functional point of view, the operators are divided into the 
following groups: logical operators, relational operators, shift/rotate operators, and 
arithmetic operators. Table 7-1 partially reflects this partition. 

Table 7-1 lists all the CALC command operators with a brief description of the 
semantics of each operator. Following are more detailed d^riptions of the nontrivial 
operators: 

1. ■ and ' (Ts complement) have the same meaning. The duplicate notation prevents 
possible difficulties on terminals where one of these characters may have a special 
meaning. 1 's complement means for every bit, a 1 bit is returned and vice versa. 

2. ! and # : 

The POS operator (!) is defined as follows: 
If number > then return true ( — 1 ) 
else return false (0). 

The NEG operator (#) is defined as follows: 
If number > then return false (0) 
else return true (^1). 

3. \ (modulo division) returns the remainder of an integer division, for example, 7 
\ 4 = 3; 16 \ 4 = 0. 

4. A (XOR) returns true only if one operand is true and the other is false; other- 
wise it returns false. This is done for each bit in the argument, for example, 
5A1=4. 



7.5. 1 Shift/Rotate Opemtors 

In the shift/rotate operations, the left operand is handled as a pattern of 32 bits. It 
is moved to the right or to the left by the number of bits specified by the right operand. 

In a shift, bits moved off one end of the pattern are lost, and bits or 1 bits are 
moved into the pattern from the other end. In a rotate^ bits moved off of one end 
move onto the other end. 

SAL and SAR are algebraic shift operators. This means that the high order bit is the 
sign bit, and there is no shift of bits between the sign and the rest of the number. In 
a left shift (SAL), bits move into the pattern from the right. In a right shift (SAR), 
either bits (if pattern is positive) or 1 bits (if pattern is negative) move into the 
pattern from the left. 

In every shift/rotate operation, the right operand (count) is always taken as modulo 
256. 
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7.6 Expression Evaluation 

Operators in the CALC command have an implied order that determines how operands 
and operators are grouped and evaluated. 

Table 7-1 lists the CALC command operators from highest to lowest precedence (i.e., 
those that take effect first am first). Operators in the same line are of equal 

precedence. 

The evaluation order is the same as that used in most programming languages. It is 
controlled first by parentheses, then by operator precedence, and finally by operator 
associativity. The CALC command first evaluates operands and operators enclosed 
in paired parentheses as subexpressions, working from innermost to outermost paren- 
theses pairs. The value of the subexpression is then used as an operand in the remain- 
der pf the expression. 

Hie precedence and fissociatMty rules are demonstrates by the following examples: 

al 4- n2 * n3 ** — n4 is equivalent to 

nl + (n2 * (n3 ** (-n4))) 

nl SHR 3 > n2 SHL n? + 4 * #2 is equivalent to 

(nl SHR 3) > (n2 §HL CflV + (4 * (#2)))) 

n2 + 3 < > n4 — 5 & n4 — 2 = = n5 is equivalent to 

((n2 + 3) <> (n4 - 5)) & ((n4 - 2) == n5) 



7.7 Examples 

See also Chapter 8 on Advanced ^ffiDtf "86 Usage for examples ustn^ tbe CALC 
command. 



7.7.1 Example 1 

S3 

The value of the S-variable S3 is d^ilafed at the message line; no assignment. 



7.7.2 Example 2 

nl = n ( n ( n2 = 2 * n3) ) 

Assuming that N3 contains 3 and N6 contains 8, and all other N-variables are zero. 
Then 2 * N3 = 6; therefore, N2 gets 6, and N6 is the index for the "outer" N 
(because N (6) is equival«ait to N6, thus giving Nl = N (N6)). N6 contains 8; thus 
Nl = N8. Because N8 contains zero, Nl gets this value (0), and is displayed on 
the message line. 



7.8 Errors 

The following messages are issued un#W ^e CALC command. When an error is 
detected, the corresponding error message is displayed on the MESSAGE line, 
followed by a portion of the eemuMnd where the error was detected. 
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Message 
Divide by zero error 
Expression too complex 

Floating point not allowei 
Illegal exponential operation 

Illegal expression 

Invalid base character 
Invalid numeric constant 
MOD by zero error 
Numeric constant too large 

Unbalanced parenthesis 
Unrecognized identifier 



An attempt was made to divide by zero. 

The expression is too complex; simplify the 
expression. 

Real values (e,g., 5.2) are not allowed. 

Usually occurs when a negative value is used as 
the right operand. The illegal exponential 
expression is displayed on the message line. 
Correct it and rerun CALC. 

The illegal expression is displayed on the message 
line. Correct it and rerun CALC. 

The base character is not valid, e.g., IAD. 

The numeric constant is not valid. 

An attempt was made to take MOD with zero. 

A numeric integer constant must be in the range 
-(2**31) to (2**31)-1. 

Either the right or left parenthesis is missing. 

The illegal identifier is displayed on the message 
line. Correct it and rerun CALC. 
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ADVANCED AEDIT-86 USAGE 



Macros give AEDIT-86 great flexibility and power. Macros can be written to incor- 
porate the CALC command and AEDIT-86 variables. These macros allow you to 
print dates, directories, use an on-line calculator, and convert letters frciByUppercase 
to lowercase and vice versa. ' 

Several macros are included with AEDIT-86 in the file USEFUL.MAC. You must 
have AEDIT-86 version V2.0 or later to use this macro file. To activate these macros, 
type the following: 



However, it is recommended that you append USEFUL.MAC to your default macro 
file (AEDIT.MAC), or include the macros you find useful in your default macro file. 
It is also recommended that the default macro file contain the appropriate configu- 
ration command to set the kattdm^ip^ M^tification for your terminal automatically 
(e.g., AH = S3E). 

The macros in USEFUL.MAC occupy about 1900 bytes of the macro buffer. The 
default macro size (3072 bytes) is usually sufficient for USEFUL.MAC. However, 
you may use the invocation control MACXi^0^iZE(mactoJbufter_j^e) if you need to 
increase the macro buffer capacity. 

The macros in USEFUL.MAC use the N-variables, N7, N8, and N9, and the S- 
variable 89 only. All other variables are not affected by USEFUL.MAC macros. 



The following macros are cont«ia^ in USEFUL.MAC. They are listed by name with 
a short descriptive sentence. 



gCACRO) B(et) 




8.1 USEFUL.MAC 



Macro Name 



Description 

The space bar may be used in addition W tiim tAB key to 
insert tabs. 



<BL> 



Find the next occurrence of the target string in the FIND 
buffer. 



Find the previous occMweaee of the target string in the 



FIND buffer. • 



L 



CoweVt- ^ character "under" the cursor to a lowercase 
character. 



U 



Convert the character "under" the cursor to m uppercase 
character. 



Convert tht'Wofi Statt^ ^miier" the (Wmr tttoi upper- 
case to lowercase letters. 



A 



Convert the word starting "under" tto emsm from lower- 
case to vpp^eesm Idttens. ' 
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< CTRL- W > Move the mimt right to the next word. 

< CTRL-Q > Move the cursor left to the previous word. 

] Set Leftcol one position to the left. 

[ Set Leftcol one position to the right. 

> Set Leftcol three positions to the left. 

{ Set Leftcol three positions to the right. 

-f W If a white space, skip to the right to the next non white 

character. 

-I-N If a nonwhite charaetel, slrtp t& the fight to the next white 

space. 

+B If a blank, skip to the right to the next nonblank. 

— W If a white space, skip to the left to the next nonwhite 

character. 

— N If a nonwhite character, skip to the left to the next white 

space. 

— B If a blank, skip to the left to the next nonblank. 

DT Insert the date in imnm ddi yyyy format (e.g., July 24, 1984) 

DM Insert the date in ckHnmm-yyyy format (e.g., 24-Jul-1984) 

Dates are as returned by the UDI DQ$GET$TIME 
procedure. 

< CTRL-B > Insert the contents of the Block buffer into the text at the 

cursor position. 

PG Page the text. Header is always written as "Heading." 

PP Page the text. Header is stored in the S9 S-variable. 

PG and PP are meant for paging text. These macros attempt 
to put headers on empty lines, if possible. They use Tag C 
and Tag D for internal computations. 

CNTR Center the text in the current line. 

DETAB Convert all tabs from the current position to the end of the 

file to blanks. 

ENTAB Convert all blanks from the current position to the end of 

the file to tabs. This macro works very slowly. 

SHL Display the current line number. 

SFL Display the total number of lines in the file. 

SFC Display the total number of characters in the file. 
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SHP 
< CTRL-R > 

SMP 

NUM 

2 
3 



5 
6 
7 



io:. 



Display ttoi^^ffrent position in the line. 

On-line calculator. In INSERT or XCHANGE modes you 
may enter an arithmetic expression. Press < CTRL-R > and 
the result is displayed at the cursor position. 

Set the indentation and left and right margins according to 
the values for the paragraph in which the cursor is currently 



Insert line number prefix on each line in a text file. The 
macro uses Tag D for internal computations. 

Set paragraph with indentation 0, left margin 0, right 
margin 70 

Set paragraph with indentation 0, left margin 3, right 
margin 70 

Set paragraph with indentation 3, left margin 3, right 

Set paragraph with indentation 3, left margin 5, right 
margin 70 

Sit i^ragraph with indentation S, left margin 5, right 
margin 70 

Set paragrajto i»4th indentation 5, left margin 7, right 
margin 70 

Set paragra]^ with indentation 7, left margin 7, right 
margin 70 "' ' 



8.2 Tips for Writing Macros 

The techniques described in this section are very useful within macros. These 
techniques will help you to understand the macros in USEFUL.MAC and to write 
your own sophisticated macros. 



8.2.1 Send Text to the liessage Line 

Sending a message to the message line is done using the CALC command with an 
expression, rather than an assignment statement, as the argument. As stated in 
Chapter 7, when the argument is an expression, its value is output to the message 
line even if it is !^ii@uted within a ma^^o. , . 

Suppose, for example, that N9 contains the current line number, and you want to 
output this value, with an appropriate title, to the message line. This is done as follows: 

C(ALC) N9=expr 

C(ALC) S9= "current line: < FETN > 9" 
C(j%LC)S9 

or in macro form: 



.CN9= expr \ NLCS9*=*%iirrent line: \ XN9" \ NLCS9 \ NL \ MM 
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8.2.2 Simulate "IF cofid THEN RETURN" (to ttie caller) 

This construct is done by using the "fail" characteristic of the FIND command. Recall 

that searching an empty string always fails (assuming that SET Go No is in effect), 
but searching zero times always succeeds, regardless of the operand. The following 
method may thus be used: 

C(ALC) N9= cond \ * cond is any logical expression * \ 

< FETN > 9 F(IND) - < RUBOUT > < ESC > 

\ * Find argument is an empty string * \ 



or in macro form: 

...CN9= cond \ NL \ XN9F- \ RB \ BR... 

Note that cond must be a logical expression, so that it will have the value of (false) 
or — I (OFFFFFFFFH, true). When it is used as a count, the absolute value, (false) 
or 1 (true) is used. 



8.2.3 Simulate "IF c<»}«r THEN ffiitefnenf' 

In this case, statement is implemented as a separate macro (named statement). This 
macro will be executed or 1 times depending on the value of cond: 

C(ALC) N9= cond 

< FETN > 9 E(XBCUTE) statement 

or in macro form: 

...CN9= cond \ NL \ XN9E sfaismenf \NL... 

Note again that cond must be a logical value to ensure that N9, when used as a 
count, is either or 1. 



8.2.4 Simulate "IF cond THEN 8tsttmnenf\ ELSE statem0nt2" 

This is based on the example given above: 

C(ALC) N8 = !(N9 = cond) \ * "!" is the NEG operator * \ 

< FETN > 9 E(XECUTE) statement [ 

< FETN > 8 E(XECUTE) statement! 

or in macro form: 

...CN8=!(N9= cond) V NL \ XN9E statementl \ XN8E statement2 \ NL... 

Note that statementl may not cliange N8; if it does, statement! may be executed 
unintentionally. 



8.2.5 Simulate "Advance.While cond' 

This construct is usually needed for macros like skip to next blank, skip to next word, 
etc. This is done using the "IF cond THEN RETURN" method described above. 
cond in this case must be a logical expression that involves the current cursor location 
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(e.g., ISDEL, CURCH = 20H). The method consists of two nested macros. The "low 
level" macro advances one character and fails when the condition is not met (named 
Advance_One). The "main" macro executes the first one an infinite number of times 
and actually terminates when the condition is not met, and continues with the next 

instruction: 



Advance. While : ... / E(XECUTE) Advance_One ... 



Advaace^One : C(ALC) N9 = \cond *' t * 

< FETN > 9 F(IND) - < RUBOUT > < ESC > 

< RIGHT* 

or in macro form: 

MAdvance_While \ BR.../EAdvan<^<lal'\ NL... 

MAdvance_One \ BRCN9«1«»nd \ NL \ XN9F- \ RB \ BR \ CR... 



If, for example, you want to implement skip to the next blank/tab, then cond is 
"CURCHO20H & CURCHOOtM^'. 

To implement Backward_While {cond), the same method is used, but the last 
command in y^MD@e_One should b» C l^BPl^ ( \ CL) iastead ®fi f RIGHT > 
( \ CR). 



8.3 Examples 

The examples included in this section are macros from USEFUL.MAC. They are 
explained in great^jdistaU to show the usage of the above techniques. 



8.3.1 

The following set of macros converts single letters or words from uppercase to lower- 
case or vice versa. It executes nested macros (e.g., macro L calls macro U2L), uses 
the CALC command (e.g., C(ALC) n8=(n9=lowch) and read-only variables (e.g., 
lowch, curch, upch), calls the SET command (S(ET) R(adix) A) and the fetch 
function (e.g., < FETN > 8). 

ML \ BReu21 \ NL \ CR \ XNSeLU 11 \ BR \ MM; \ * letter to lower case * \ 

MU \ BRel2u \ NL \ CR \ XNSeLU 1 1 \ BR \ MM; \ * letter to upper case * \ 

M_\ BRe + W\NL/ell2\ NLe + W \ BR \ MM; \ * word to lowercase * \ 

MA \ BRe+ W \ NL/eul2 \ NLe+W \ BR \ MM; \ * word to upper case * \ 

MU2L \ BRCN8 =(N9 =lowch)<>curch \ NL \ MM; 

ML2U \ BRCN8 = (N9 = upch )<>curch \ NLVMI^ 

MLUl 1 \ BR \ CLsrax \ XN9 \ BR \ MM; 

ML12 \ BRCN7 = iswhte I eof \ NL \ XN7f- \ RB \ BRl \ MM; 

MU12 \ BRCN7=iswhte I eof \ NL \ XN7f- \ RB \ BRu \ MM; 

Htii^ the use of ta foUowioi tgdw^aea^ 

• Macro L executes LUl 1 using the IF cond THEN statement 

• Macro LI 2 simulates Advance_While the current character is a white 
In this case, it also converts the character to lowercase. 

• Macro _ (tiliderseore) mes + W to skip to ^ uett lieHlwItle spaee ^aracter. 
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8.3.2 Example 2 

Macro < CTRL-W > moves the cursor one word to the right. A word (in this case) 
is defined as a sequence of characters enclosed by delimiters. Delimiters are defined 
as white spaces or the user defined delimiters (listed under SET E_delimiter). The 
technique IF cond THEN RETURN is used here. In the nested macros, N9 defines 
whether or not the cursor is on a delimiter. If the value fetched by < FETN > 9 is 
(false), the FIND succeeds and the macro is repeated. If the value fetched by 
< FETN > 9 is I (true), the FIND fails and execution returns to the calling macro. 

M \ 017 \ BROf- \ RB \ BR/e \ 0171 \ NL/e \ 0172 \ NL \ MM; \ • word right macro * \ 
M \ 0171 \ BRcn9=iswhte \ NL \ XN9f \ BR \ CR \ MM; 
M \ 0172 \ BRcn9 = !isdel \ NL \ XN9f \ BR \ CR \ MM; 

Macro < CTRL-Q > differs from macro < CTRL-W > only in that it moves the 
cursor one word to the left. 

M \ 01 1 \ BROf- \ RB \ BR \ CL/e \ 01 1 1 \ NL/e \ 01 12 \ NL \ CR \ MM; \ * word left macro * \ 

M \ 01 12 \ BRcn9 = iswhte \ NL \ XN9f \ BR \ CL \ MM; 
M \ 1 1 1 \ BRcn9 = lisdel \ NL \ XN9f \ BR \ CL \ MM; 

Note that the macros are optimized to some extent. A find empty string is issued 
fiKit; therefore, a future FIND command uses < ESC > as an argument, not the 
sequence - < RUBOUT > < ESC > . 



8.3.3 Example 3 

Macro CNTR centers the text on the line. This macro strips all blanks from the left 
side, then all blanks from the right side. It calculates the number of blanks to be 
added and adds the blanks from the left margin to the first character so that the text 
is centered on the line. Skipping blanks is done with the +B and the — B macros. 
The number of blanks to be added is calculated using the read-only variables 
RMARGN, LMARGN, and COL. +B and -B use Advance. While macro 
techniques. 

MCNTR \ BRjpO \ NLe-l-b \ NL \ XXjp254 \ NLi \ BR \ CLe-b \ NL \ CR 

\ XA cn9 = (rniargn+ 1 +lmargn-col)/2 \ NLcn9= -n9*(n9>0) \ NLjpO \ NLi \ BRb 

\ CLb \ XF \ XN9g \ NL \ NL \ MM; 

M-l-B \ BR/e-l-Bl \ BR \ MM; 

M-l-bl \ BRcn9=!(eurch= =20H) \ NL \ XN9f- \ RB \ BR \ CR \ MM; 
M-B\BR/e-Bl \BR\MM; 

M-bl \ BRcn9 = !(curch= =20H) \ NL \ XN9f- \ RB \ BR \ CL \ MM; 
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CHAPTER 9 
CONFIGURATION COMMANDS 



9.1 Introduction 

AEDIT-86 is designed to run within several environments and with various terminals. 
In some cases — for example, Series IV AEDIT-86 is able to identify the host environ- 
ment. In other cases, you si^ivM specify the characteristics of your particular 
environment or terminal. 



The characteristics of your environment or terminal are specified with configuration 
commands. The parameters and control sequences that must be specified are listed 
in Table 9-1. 



Configuration commands must be given in a macro file. It is recommended that the 
required commands for your environment or terminal be included in your default 

macro file. A configuration command must be terminated with a semicolon (;) or a 
carriage return. For the Series III, Series IV and ANSI/VTIOO family of terminals, 
only the appropriate hardware identification configuration command, AH=string, is 
required. Appendix F lists macro files for several non-Intel terminals. If your termi- 
nal is not included in the list of tested terminals, please refer to your terminal user 
manual for the termnal characteristics. 



AEDIT-86 requires that the terminal meet the following conditions; 

• ASCII codes 20H-7EH display some symbol that requires one column space. 
Carriage return (ODH) and linefeed (OAH) perform their usual functions. 

• The following cursor functions have cursor key input codes and CRT cursor output 
codes: left, right, up, down, home and carriage return. Output codes such as clear 
screen, clear rest of screen, clear line, clear rest of line, and direct cursor address- 
ing are desirable for faster screen plotting, but not required. The codes, shown in 
Table 9-1, can be changed with the configuration commands. 

» The CRT accepts a blankout code that blanks out the former contents of the 
screen location to which it is output. The default, 20H, can be changed with the 
configuration commands. 

• AEDIT-86 automatically generates a linefeed each time a carriage return is 
entered. Your terminal should not transmit a linefeed with a carriage return. In 
some terminals, this feature can be switched on and off. 



Table 9-1 lists the configuration commands and their meanings. These commands 
are divided into three groups: 

• Terminal attributes and generals 

• Input codes — specify codes sent from the keyboard to the terminal (i.e., 
AEDIT-86) 

• Output codes — specify codes to be sent from the terminal (i.e., AEDIT-86) to 
the display. 



A configuration cominand may be used to set a value to a specific feature or to indicate 

that the feature is not available. To indicate that the feature is not available, the 
command is specified without an associated value, e.g., AFER = ; . 
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Table 9-1 . Configuration Commands 



Command 


Meaning 


Terminal Attributes and Generals 


AH= string 


Hardware Identification 


string stands for one of the following values. Each of the specified values Implies a set of 
conf iguration commands. 


< null > 


Equivalent to specifying the minimal default set, which is 
specified with AH = ;. The default set is not sufficient for 
interactive use and must be completed vi^ith other explicit 
configuration commands. 


S3 


Series III systems. Equivalent to specifying all configu- 
ration commands with the Series III default values. 


S3E 


Equivalent to S3 with the following changes: 

• iNew console ouipui lunciions, inciUQiny — 
-Various clear text functions 

-Direct cursor addressing 
-Local scrolling 

• Fast-Block-Move command for data to the CRT 


S3ET 


Equivalent to S3E w^ithout the Fast-Block-Move 
command for data to the CRT. S3ET is used when the 
Series HIE is used as a terminal rather than as a host. 


S4 


Series IV systems. Equivalent to specifying all configu- 
ration commands with the Series IV default values. 


ANSI 


Equivalent to specifying all the configuration commands 
with the default values according to ANSI X3.64 (1977). 
The ANSI cursor addressing codes, as dsfin«j in this 
standard, are supported. 


VT100 


Equivalent to specifying all the configuration commands 
with the default values for the DEC VT100 family of 
terminals. This includes VT100 ANSI cursor addressing 

codes. 


AV = n (5:66) 


Sets the number of rows in the display. 


AW=T or F 


True If the terminal wraps when a character is printed in 
the last physical column. 


AS=Tor F 


True to display the busy/waiting indicator. 


AT=T or F 


True if type-ahead is to be done by AEDIT-86. Must be 
False for iRMX-based system. 


Input codes 


Escape keys: 




AB^hhhh 


Sets <ESC> 


AFCC=/J 


Sets <CTRL-C> synonym 


Cursor move keys: 




AFCL=/7/7/l/T 


Sets <LEFT> 


AFCR=/J/J/Ji7 


Sets < RIGHT > 


AFCU =hhhh 


Sets <UP> 


AFCD= hhhh 


Sets <DOWN> 


AFCH= hhhh 


Sets <HOME> 
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Table 9-1 . €iMi%Brattoii CfHraamndis (Conl'd . ) 



Command 


Meaning 


AR=/i/7/i/i 
AFXf =hhhh 

/K\'XX = hhhh 
AFXA=/i/7/irt 
AFXZ= hhhh 

AFXU = /(/)/i/; 


^ iimJBOUT> < 
Sets Delete Character- < DELCH > 

Sets Delete Left- < DELL > 
Sets Delete Right- < DELR > 
Sete Delete Line- < DELLI > 


Prefix keys: 

AFXB= hhhh 
AFXH = hhhh 
AFXN = /j/7/j/7 
AFXS=/»/»/l/» 


Sets Macro Exec key- < MEXEC > 
Sets HEX character- < HEX > 
Sets Fetch Numeric- < FETN > 
Sets Fetch String- < FETS > 


Others: 

AFIG=/i 


Sets character(s) to be ignored. This specification is 
needed on terminals (such as the Hazeltine 1510) that 
have multiple character key codes for UP and DOWN. 
AFIG should be set to the lead-in (tilde), and UP and 
DOWN should be set to the second letter of the cursor 
up or down key code. This avoids problems caused by 
the lack of a type-ahead buffer. 


Output Codes 


Blank: 

AFBK=h 


SttSllmA character 

< SLANK > on most terminals 


Cursor moves: 

AFML= hhhh 
AFMR = hhhh 
AFMV= hhhh 
AfMD= hhhh 


Moves oiEsor to Mart of Hne 
Moves cursor left 

Moves cursor right 
Moves cursor up 
Moves cursor down 

Moves cursor home 


grase: 

AFES = /jWlft 
AFER = /7A)/7h 
AFEK=/j/l/7/7 
AFEL=/J/J/J/) 


- ^ ! 

Erases entire screen 
Erases rest of screen 
Erases entire line 
Wif»$mimst of line 


Cursor addressing: 
APAC=hhhh 

AO=h 

AX=T or F 


Addresses cursor lead-in. 

When used, code will be followed by column number (0 
to max_col_value) and row number (0 to max_row- 

_value). 

Offset to add to both row and column number with 

address cursor commands. 

True if X (column) precedes Y (row) in address cursor 

command. 
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TaMs 9-1 . Configiuation Conwiands (Cont'd . ) 



Command 


Meaning 


Delete/insert: 

Af\L=hhhh 
AFDL=hhhh 


Insert line code. Used in line for reverse scrolling. 

Delete line code. Used to speed up display on the Hazel- 
tine 1510 and similar terminals. 


Reverse video: 
AFRV=/)/7/jAi 

AFm =tmh 

AI=T or F 
AC=Tor F 


Start reverse video character(s). Used on the PROMPT 
line display. 

Return to normal video characters. Used to restore the 
display after a reverse video line. 

True if the CRT has invisible attributes, or False if the 

attribute occupies a position on the screen. 

True if the CRT has attributes per character, or False if 
the attributes are per field. 


Initialization/termination: 
AfST=hmh... 

AFEN=hhhh... 


Start-sequence. This sequence is output to the terminal 
when AEDIT-86 encounters it. Can be used to initialize 
the terminal, e.g., to initialize a scrolling region. 

End-sequence. Output to the terminal when AEDIT-86 
exists. Can be used to unset values that have been set 
by AFST. 



NOTES: 



n(nt:/i^ an integer in the inclusive range, n1 to n2. 

h a 1 -byte hex number. 

hhhh a 1- to 4-byte hexadecimal number. 

hhhh... the same as hhhh, but the length may be up to 40 bytes. 

T 7 or t indicates true. 

F F or f indicates false. 

string a 0- to 60-character string. 



9.1.1 Configfiration Coniinand Notes 

AT This feature must be off (AT=F) for iRMX-based systems due to current 

iRMX internal requirements. Setting AT = F directs AEDIT-86 not to 
support type-ahead. Because the iRMX operating system performs type- 
ahead, setting this fimction off does not affect the user. 

When AT is off (AT=F), the AFCC function is not fully functional. The 

synonym works only for synchronous operations (e.g., to terminate 
INSERT mode), but not for asynchronous operations (e.g., exit from a 
loop within a macro). 

AB The natural choice is ESC (IBH). However, this value cannot be used if 

other terminal input functions begin with ESC (e.g., VTIO). 

AFCC AFCC is not fully functional if AT is off (AT = F). See notra on AT above. 



9.2 Configuration Values 

The hardware identification command AH may have several different values, e.g., a 
null string, the string S3E, the string S4. An AH command value implies a complete 
set of values for the entire configuration command set. Table 9-2 contains the default 
configuration commands with values for various terminals or systems. 
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Ti^"!^!. Configuration Vahiies 



Command 


AH = ; 


AH = S3 


AH=S3E 


AH=S4 


AH = ANSI 


Meaning 


Default 


(SIH) 


(S HIE) 


(SIV) 


AH-VT100 


Terminal Attributes and Generals 


AV = 


24 


25 


25 


25 


24 


Screen length 


AW = 


T 


F 


T 


F 


F 


Terminal wraps? 


AS = 


T 


T 


T 


T 


T 


Display busy/w/aiting 














indicator 


AT = 


T 


T 


T 


T 


T 


Type-ahead 


Input codes 


Escape keys: 














AB = 


IB 


IB 


IB 


IB 


1 B4F53'^' 


Sets <ESC> 


AFCC= 


03 


03 


03 


03 


03 


Sets <CTRL-C> 


Cursor move 














keys: 
















(1) 


■j p 


1 F 

1 r 






Cote f 1 PPT \ 


AFCR = 




14 


14 


8A 


1B5B43 


Sets < RIGHT > 


AFCU = 




IE 


IE 


87 


1B5B41 


Sets < UP > 


AFCD = 




1C 


1C 


88 


1 B5B42 


Sets < DOWN > 


AFCH = 




1D 


ID 


81 


184F50<*i 


Sets < HOME > 


Delete keys: 














AR = 


7F 


7F 


7F 


7F 


7F 


Sets <RUBOUT> 


AFXF = 


06 


06 


06 


80 


06 


Sets < DELCH > 


AFXX = 


18 


18 


18 


18 


18 


Sets < DELL > 


AFXA = 


01 


01 


01 


01 


01 


Sets < DELR > 


AFXZ = 


1A 


1A 


1A 


82 


1A 


Sets < DELLI > 


AFXU = 


15 


15 


15 


15 


15 


Sets < UNDO > 


Prefix keys: 














AFXE= 


05 


OS 


05 


05 


05 


Sets <MEXEC> 


AFXH = 


08 


08 


08 


08 


08 


Sets < HEX > 


AFXN = 


OE 


OE 


OE 


OE 


OE 


Sets <FETN> 


AFXS= 


13 


13 


13 


13 


16^ 


Sets <FETS> 


Others: 














AFIG= 












IpiQre #uracter 


Output codes 


Blank: 














AFBK= 


20 


20 


20 


20 


20 


8lankout character 


Cursor 














moves: 














AFMB = 


CD 


OD 


OD 


OD 


OD 


Carriage return 


AFML = 




IF 


IF 


08 


1B5B44 


Cursor left 


AFMR = 




14 


14 


1B43 


1 B5B43 


Cursor right 


AFMU = 




1E 


IE 


1B41 


1B5B41 


Cursor up 


AFMD = 




1C 


1C 


1B42 


1 B5B42 


Cursor down 


AFMH = 




ID 


ID 


1848 


1B5B48 


Cursor home 


Erase: 














AFES = 




1845 


1B45 


1B45 


1 B5B324A 


Entire screen 


AFER = 




1B4A 


1B53 


1B4A 


1B5B4A 


Rest of screen 


AFEK = 




1B4B 


1B4B 


0D1B4B 


1 B5B324B 


Entire line 


AFEL= 






1852 


184B 


185848 


Rest of line 
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Table 9-2 . ConCiguratioii Values (Cont'd . ) 



Conmiafid 


AH = ; 
Default 


AH = S3 
(S III) 


AH = S3E 
(S HIE) 


AH = S4 
(S IV) 


AH = ANSI 
AH = VT100 


Meaning 


Cursor 
addressing: 

AFAC= 

AO= 

AX= 


— 


— 


1B59 
20 
F 


1B59 
20 
F 


1 Bx; y48i=' 


Address lead in 
Row/coiumn offset 
X (col) before 
Y (row) 


Delete/insert: 

AFIL= 
AFDL= 






1B57603F 
1B573F60 




1 B5B4C<=i 
1 B5B4D'^' 


insert line 
Delete line 


Reverse 
video: 

AFRV= 
AFNV= 
Al = 
AC= 






1 B4C90 
1 B4C80 

F 

F 


1 B4C50 
1 B4C40 

F 

F 


1B5B376D 
1B5B6D 

T 

T 


Reverse video 
Normal video 
Invisible attributes? 
Character attributes 


Initialization/ 
termination: 

AFST= 
AFEN = 












Start-sequence 
End-sequence 



NOTES: 



1 . — means the feature is either unavailable or meaningless. 

2. Because 1 B Is used as a prefix for input sequences on ANSI terminals, it may not be used as 

< ESC > . The choice of the FP4 key (for AH=VT100) or 04H (for AH = ANSI) is arbitrary and 
may be changed. 

3. < GTRL-S > may cause problems with the VT1 00 and other terminals. Choose another Itey (e.g., 

< CTRL-V > ). 

4. In the absence of a "natural" <HOME> key, the choice of the FP1 l<ey (for AH=VT100)or OCH 
(for AH = ANSI) is arbitrary and may be changed. 

5. The ANSI escape sequence for cursor addressing is hard-coded in AEDIT-86. The table shows 
the format only. This format cannot be coded using AFAC. 

6. Insert/Delete line functions, although available on the VT100, are disabled because of poor 
performance. 



9.3 Delay Codes 

Some CRTs are too slow with respect to some AEDIT-86 output functions. To enable 
a smooth operation of AEDIT-86 with these CRT types, AEDIT-86 should be 
informed how long it has to wait before it may issue a new output operation. 

Delay codes for the various output functions can be specified by configuration 
commands of the form ADxx= hhhh, where xx is the function code in the correspond- 
ing AFxx code, and n is a decimal number specifying the delay in milliseconds. An 
ADxx value may be specified for every output function for which a corresponding 
AFxx value may be applied. For example, ADDL = 30 defines a delay of 30 millise- 
conds for the function AFDL (delete line). 

The default for all delay codes is no delay at aH. 
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9.4 Determining thie Configuration Values 

The default values are given in Table 9-2. 

The following list describes the order in which AEDIT-86 processes £^Q%aratei- 
command-related information: 

1. Sets the default value for each configuration command. 

2. Checks to see if the system is a S 111. If the system-id is SERIES Mi, thmtdts 
the configuration commands as defined under S 111 in Table 9-2. 

3. Checks to see if the system is S IV. If so, then sets the configuration commands 
as defined under S IV in Table 9-2. 

4. Processes the macro file (which may contain configuration commands). For every 
legal command, overwrites the previous value with the one newly specified. 

When the above process is finished, the configuration set is checked automati- 
cally. The following configuration commands must have a defined value: 

AFMB, AFMH, AFMU, AFMD, AFML, AFMR. and AF»K. 

During AEDIT-86 operation, new macro files can be loaded using the MACRO Get 
command. After each addition, step 4 above is repeated, but the check for the minimal 
set of defined configuration commands is ii@t £^Cfii| •cn^- 

NOTE 

AEDIT performs no consistency <^ecks on the configuration commands. In 

particular, there is no check as to whether two input codes have the same 
hex value or one is the prefix of the other. In such a case, the result is 

l^Tor. "insufficient eonfiguration emsands" is displayed and the AEMT-86 session 
is terminated with the error if one More of the configuration commands AFMB, 
AFMH, AFMU, AFMD, AFML, AFMR, or AFBK does not have a defined value. 
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AEDIT-86 COMMAND SUMMARY 



This appendix lists the AEDIT-86 commands, their formats and functions. In the 
alphabetic list, < CTRL > represents the CONTROL key. Aflgle brackets ( < > ) 
indicate a key configured for a function. 



A.1 Function Keys 



The following commands are executed by pressing the specifically configured key or 
by typing the indicated < CTRL > commands. 



Command 
<LEFT> 

< RIGHT > 
<UP> 

< DOWN > 
<HOME> 

< RUBOUT > 

< DELCH > 

< DELLI > 

< DELL > 
«I>ELR> 
<UNDO> 

<ESC> 

< CTRL-C > 

< RETURN > 
<TAB> 



Function 

Moves cursor left, left arrow. 
Moves cursor right, right arrow. 
Moves cursor up, up arrow. 
Moves cursor down, down arrow. 

Allows fast cursor meviment or permits entry into reedit mode. 

Deletes character to left of cursor at main command level or 
INSERT mode. In XCHANGE mode, < RUBOUT > exchanges 
the new charw^ te ^ left of the cursor witti #e original 
character. 

Deletes the character "under" the cursor (usually canfigured to 

< CTRL-F > ). 

Deletes the entire line on which the cursor is positiooed (usually 
configurefd W < CTRL-Z > ). 

Deletes all characters to the left of the cursor (usually configured 
to <CTRL-X »). 

Deletes all characters to the right of the cursor (usually confl- 
guredto <CTRL-A>). 

At the cursor position, restores the characters deleted by the last 

< DELL > , < DELR > , or < DELLI > command (usually 
fkmngat&i m < CTRL-U>). 

Terminates commands and sends the entire string, or exits the 
mode and return eitt@r to main command level. 

Aborts command in progress and returns editor to main command 
level. 

Moves cursor to start of next line. 

Rotates the menu prompt line to display the next line of 
commands or, in INSERT or XCHANGE mode, inserts tab or 
equivalent number of blanks. 
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< HEX > Inserts a character in the text as its ASCII value (usually confi- 

gured to < CTRL-H > ). < HEX > should be followed by two 
digits that are interpreted as the hexadedmal value. 

< FETN > Fetches a global numeric variable (usually configured to < CTRL- 

N > ). < FETN > should be followed by a numeric value from 
0-9. 

< FETS > Fetches a global string variable (usually configured to < CTRL- 

S > ). < FETS > should be followed by a numeric value from 0-9, 
or a second letter from one of the read-only string variables. 

< MEXEC > Executes a macro called by a single-character name (usually 

configured to < CTRL-E > ). < MEXEG > should be followed 
by a valid one-character macro name. 



A.2 AEDIT-86 Edfting Coififtiands 

The following is an alphabetic list of the AEDIT-86 editing commands, their formats 
and functions. 



Command 

AGAIN 

BLOCK 

Buffer 
Delete 

Find 
-find 
Jump 
Put 

DELETE 

FIND 

-FIND 



Format 

[count]A 

B or D 

B 
D 



J 
P 

B or D 
[count] F 
[count] - 



Function 

Repeats the last command or 
subcommand. 

Delimits a section of text that can 
then be deleted, moved, or copied. 

Copies text to the Block buffer. 

Deletes the delimited section and 
moves it unchanged to the Block 
buffer. 

Same as in main command level. 

Same as in main command level. 

Same as in main command level. 

Copies the delimited section of 
text to a specified output file. 

Delimits section of text that can 
then be deleted, moved, or copied 
(same as in BLOCK command). 

Searches forward from current 
cursor position for string. Moves 
cursor if found. 

Searches backward from current 
cursor position for string. Moves 
cursor if found. 
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AJBS^-M OmamA Soamiiury 



Input 

Output 

INSERT 

JUMP 

A_tag 
B_tag 
C_tag 
D_tag 
Start 

End 
LioiB 

Position 

KILL_WND 

OTHER 
PARAGRAPH 



I 

o 

[/]! 
J 

A 
B 

C 
D 

■S: 

E 
L 



O 



[count] P 



Fill F 
Justify J 
QUIT Q 



Retrieves contents of Block buffer 
or external file; places contents at 
current cursor position. Count 
oust be a finite number. 

Hex command 

Inserts the ASCII equivalent of 
hexadecimal valu^ in text. 

Displays hexadecimal values of 
ASCII characters in message line. 

Begins INSERT modr. iftilits 
text at cursor position. 

Moves cursor to a specified 
location in text. 

Moves cursor to tag A. 

Moves cursor to tag B. 

Moves cursor to tag C. 

Moves cursor to taf W'.. 

Moves cursor to the start of the 
file. 

Moves cutMV «»tte ^fif he fie. 
Moves cursor to tbs SfiKt of the 

Moves cursor to the designated 
position in the current line. 

Deletes the secondary window and 
extends the current window. The 
cursor remains at its current 

position. 

Switches between main and 
OTHER files. 

Reformats the paragraph using 
the values for indentation, left and 
right margins set with the SET 
Margin command. 

The paragraph is reformatted with 
no right-justification 

The paragraph is reformatted with 
right-justification. 

Ends, updates, restarts, etc., the 
editing, depending on the 
subcommand. 
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Abort 
Exit 
Init 

Update 
Write 

REPLACE 

7REPLACE 
SET 
Autonl 

Batcffle 

Cme 

Display 
E_delimit 

Go 

Mghbit 
Indent 



4EDIT-86llsar*s0aiie 



B 
I 

U 

w 

[eocfnt] R 

[count] 1 
S 
A 

B 



D 



H 



Returns to operating system; all 
changes are lost. 

Returns to operating system; the 
file is updated. 

Restarts editing; initializes new 
file withoot returning to operating 
system. 

Updates file without retumifflg to 

operating system. 

Writes file to the output file 
specified without returning to 
operating system. 

Searches forward for target string; 
replaces it with new string if 
found. 

Conditional REPLACE command. 

Sets several AEDIT-86 features. 

While in INSERT mode, inserts 
carriage return in text automati- 
cally when line is full 
(default = no). 

Creates a backup file of the file 
being currently edited when QUIT 
Update or QUIT Exit is executed 
( default = yes). 

Tells editor to consider case of 
strings during (-)FIND and 
(?)REPLACE commands 
(default=no). 

Displays any movements in or 
changes to the text during macro 
execution (default=no). 

Defines the token delimiters 
(default = !"#%&'()* + , 
-./:;< = > ?@[ \ -C 
1 > - ). 

Continues macro execution even if 
a (-)FIND/(?)REPLACE 
command in the macro fails 
(defamlt=no). 

Displays all text characters with 
hexadecimal values over 7FH as 
is instead of ? (default = no). 

Indents inserted/exchanged text 
automatically (default=no). 



A-4 



AEEirr-46 User's Guide 



A^IT-86 ConiBuuid SniMBary 



K_tokeri 



Leftcol 



Margin 



Notab 
Radix 

Alpha 
Binary 
Decimal 
Hex 
Octal 
Showfind 

Tabs 
Viewrow 



M 



N 

11 

A 
B 
D 
H 
O 

s 

T 
V 



A string in the text needs to be a 
token string to be found 
(default = no). 

Allows you to view lines over 80 
characters long (default=0). 

Sets indentation, and left and right 
margins used by the 
PARAGRAPH and SET Autonl 
commands (default: indent = 4, 
left=0, right=76). 

Inserts blanks in place of tabs in 
INSERT or XCHANGE mode 
(default = no). 

Sets the radix by which a numeric 
variable is output by < FETN > 
in INSERT or XCHANGE mode 
(default = Pecig^aJ). 



TAG 



J 



Lists target-String lines of multiple 
search commands (M'nalt^ito). 

Sets tab positions (default = 4). 

Sets the row to which text is 
moved relative to the screen 
on VIEW &mmmi- (default = 
row 5). 

Specifies locations in a file; used 
with the JUMP command. 



A_tag 
B^tag 
C_tag 
D_tag 
VIEW 



A 
B 
C 
D 
V 



Rewrites (moves) text on the 
screen leaving cursor in viewrow 
(default=row 5). 
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WINDOW 



XCHANGE 



W 



Splits the text area of the screen 
in two, enabling the user to look 
at two different parts of the same 
file or two different files. 

Enters XCHANGE mode; 
replaces characters on a one-for- 
one basis. 



A.3 AEDIT-86 Advanced Commands 

The following is an alphabetic list of the AEDIT-86 advanced commands, their 
formats and functions. 



Command 

CALC 
EXECUTE 
MACRO 
Create 

Get 

Insert 
List 

Save 



Format 

C 

[count] E 
M 
C 

G 



Function 

Provides computing capabilities. 

Executes specified macro. 

AUows you to manipulate macros. 

Creates macros interactively by 
accumulating a sequence of 
keystrokes. 

Retrieves macros from an exter- 
nal file or from the current text 
buffer. 

Inserts subsequent input in text in 
macro form. 

Lists the names of all currently 
defined macros on the message 
line. 

Translates macros to macro form 
and inserts the definition at the 
current position in the text. 
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AEDIT-86 ERROR MESSAGES 



This appendix lists the error messages reported by AEDIT-86 when a proMeoi is 
(mcountered in the invocation line, editing command, CALC command, or macro file. 

B.1 Invocation Errors 

AEDIT-86 issues a message when an error occurs in the invocation line. AEDIT-86 
displays the sign-on message follow^ % tte error message, and control returns to 
the operating system. 

Invocation errors have the following form: 

•**IRROR: illegal Invocation, NEAR: token 

or 



• • *ERRDR : 



message 



message 

Message 

Conflicting controls 



is an invocation command item. 

is one of the following error messages. 

Explanation 



Insufficient configuration 
commands 



Insufficient memory 
Macro buffer too large 

Macro buffer too small 



An illegal combination of VIEWONLY and 
FORWARDONLY controls is used. 

The interactive session has been initialized; however, 
required configuration commands of the type AFMx 
or AFBK are undefined. 

AEDIT-86 does not have a large enough RAM parti- 
tion. 

The macro buffer size specified is too large, and the 
buffer size remaining is insufficient for the text to be 
edited. 

The macro buffer size specified is less than the 
Ktii^Bum allowed. 



B.2 Editing Command Errors 

Message Explanation 

bad indent maffpl ' Attempt to set indent margin out of the legal range. 

Editor returns to main command level. 

bad left margin Attempt to set left margin out of the legal range. 

Editor returns to main command level. 
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bad right margin 



bad tabs 



bad Leftcol 



bad Viewrow 



block buffer too large for SB 



cannot delete more than 32 



illegal command 



illegal invocation 



insufficient terminal 
capabilities 



invalid hex value 



invalid variable name 



macro creation is forbidden 
while executing a macro 

macro nesting too deep 



no more room for macros 
no such macro 



Attempt to set margins out of the legal range. Editor 
returns to main command level. 

Attempt to set right margin out of the legal range. 
Editor returns to main command level. 

Attempt to set bad tabs; e.g., 4,2 is illegal since the 
second value is less than the first. Editor returns to 
main command level. 

Attempt to set bad left column, Leftcol accepts any 
number from to 176. Editor returns to main 
command level. 

Attempt to set bad viewrow. This value must be 
between and (text size — 1 ). Editor returns to main 
command level. 

Attempt to specify < FETS > B or SB when the 
current block buffer is greater than 60 characters. 

Attempt to use count greater than 32 with 

< DELCH > command. Editor returns to main 
command level. 

Attempt to enter illegal and/or unknown command. 
Editor ignores command. 

Attempt to invoke AEDIT-86 with an illegal invoca- 
tion line, or an illegal invocation under QUIT Init. 

Attempt to set windowing on a terminal that does not 
have AFEK or AFEL output functions. Editor returns 
to main command level. 

Attempt to input an invalid hexadecimal value. Editor 
returns to main command level. 

Attempt to input an invalid value for < FETS > or 

< FETN > . 

Attempt was made to define a macro while a macro 
was being executed. 

Nesting level for macros exceeded. A maximum of 
eight levels is allowed. 

Macro buffer is full. 

Attempt to execute macro that does not exist. Editor 
returns to main command level. 



not found: ''target string" 



some text lost 



Target string not found. Editor returns to main 
command let^el. 

In FORWARDONLY, the file is larger than the 
allaeated memory. 
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text does not Ht 



filename 

{error message supf^ied by 
operaVrtg system) 

Xchange limit li 



window too small 



Attempt to edit a file that is too large under the 
FORDWARDONLY controL Editor returns to main 
command level. 

An error occurs during a QUIT Exit, QUIT Init, 
QUIT Update, GET, or BLOCK Put command. 
Editor retunp to main command level. 

Attempt to exchange over 100 characters without 
restarting XCHANGE mode. Editor remains in 
XCHANGE mode. 

Attempt to split screen with one window size less than 
five lines. 



B.3 CALC CommaiKl Irmfw 

The following messages are issued only under the CALC command. When an error 
is detected, the corresponding error message is displayed on the MESSAGE line, 
followed by a portion of the o>mmand where the error was detected. 



Messnge 
Divide by zero iitor 

Expression too complex 

Floating point not allowed 

Illegal exponenM 
operation 

Illegal expression 

Invalid base cbacacter 
Invalid numeric constant 
MOD by zero error 



An attempt Wi>s -Aaie t& itti<M& by mna- ' ' 

The expression is too complex; simplify the expression. 

Real values (e.g., 5.2) are not allowed. 

Usually occurs when a negative value is used as the 
right operand. The illegal exponential expression is 
displayed on the message line. Correct it and rerun 
CALC. 

The illegal expression is displajisd ^ ttsi^ 
correct it and rerun CALC. 

The base character i$ not valid, feg., IAD. 

The nvtnml^ eonstant is aatmUL 

An attempt was made to take MOD with zero. 



Numeric constant too large A numeric integer constant must be in the range 

-(2**31) to +(2**3l)— 1. 



Unbalanced parenthesis 

Unrecognized identifier 



Either the right or left pi^«xtibi^s is missing. 

The illegal identifier is dismayed on the message line. 
Correct it and rerun CALC. 



B.4 Macro File Errors 

If any error is found in a macro file, one of the following messages is printed. Macro 
file proce^ing cetntinues. 
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Macro errors have the following form: 
Error in line nnn : < messagey 
where 



nnn 

< message > 
Message 
bad \ code 
bad AC value 
bad AF type 
bad AH value 
bad AI value 
bad AS value 
bad AT value 
bad AV value 
bad AW value 
bad AX value 
bad command 

bad hex value 

missing '=' 
missing ';' 



is the line number containing the error in the macro file, 
is one of the following error messages. 

Explaimtion 

Backslash ( \ ) is not followed by a valid value. 

Illegal AC configuration command. 

Illegal AF configuration command. 

Illegal value for fee AH fiiflfigtiration caMmand. 

Illegal AI configuration command. 

Illegal AS configuration command. 

Illegal AT configuration command. 

Illef al value far the AV eonfiguration «»mmand. 

Illegal AW configuration command. 

Illegal value for the AX configuration command. 

Macro file contains a bad command — unknown control 
code or character. 

Configuration command contains bad hex value, e.g., 
3G. 

A conBguration command is missing an equal sign. 

SET command is not terminated with a semicolon or 
carriage return. 



no macro name 

no more room for macros 



Macro definition does not include macro name. 

Attempt to create a macro when macro buffer is full. 
Macro definition is terminated. 
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AEDIT-86 will run on the Series III Microcomputer Development System under the 
ISIS/RUN operating syst^. 



C.1 Invocation Cominand 

The invocation line is as described in Chapter 4. tt jGn Me WM m tbe RUN subsys- 
tem, the invocation must be preceded by RUN. 

If you are starting the tutorial in Chapter 1, tjrpe the following: 



0.2 Terminate Used with the Sefto M System 

The Series III system may be connected to various t^M^ais: 

• Integrated Series III terminal 

• Integrated Series IIIE terminal (with the 51 HOC firmware) 

• Other terminals connected to the Series III via a serial channel 

Descriptions of the Series III and Series HIE follow in l;bi§ appendix. See Appendix 
F for working with other terminals. . i 



C.S Integrated Series fH Tttrminal 

C.3.1 Configuration Commands 

The hardware identification value AH is S3 for the integrated Series III terminal. 
This is the default hardware identificati<ffl AEDIT-86 if the system-id, as returned 
by UDl, is Series III. Configuration commands for the Series III terminal are 
presented in Table 9-2. 

0.3.2 SeraWid 

Scrolling at the main command level causes the message and prompt lines to disap- 
pear. When scrolling is complete, the message and prompt lines are rewritten as soon 
as a command (other than a cursor movement command) is typed. The integrated 
Series III terminal has no reverse scrolling. 



C.4 hitegrated Series IIIE Terminal 

The integrated Series IIIE terminal is an upgrade of the integrated Series III termi- 
nal. An integrated Series III terminal may be upgraded to Series IIIE by installing 
the 5 1 1 IOC firmware. The int^rated Serto IIIE terminal has the following additional 

features: 

• Direct cursor addressing 

• Additional output function codes (e.g., delete line, insert line) 

• Fast block movement to the CRT 
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AEDIT-86 executes much faster on the integrated S&riet HIE terminal than on the 
regular integrated Series 111 terminal. 

C.4.1 Configuration Commands 

To use Series 111 with the integrated Series lllE terminal, use AH=S3E configura- 
tion command. If the integrated Series HIE terminal is used as a terminal for another 
host (via asynchronous communication), use AH = S3ET. In this case, the fast bloclc 
movement feature is not exploited. Configuration commands are presented in 
Table 9-2. 

C.4.2 Using Serial Channels with the Integrated Series HIE 
Terminal 

If you are using AEDIT-86 with the integrated Series HIE terminal and you have 
devices attached to either of the serial channels, your terminal could "freeze" if a 
device sends data sequences to the terminal. Disconnecting such devices beforehand 
is recommended; however, this problem, when it occurs, is refolved by pressing the 
system Interrupt 7 key. 



C.5 Work File 

The predefined file :WORK: must be properly assigned when AEDIT-86 is invoked. 

If you are using ISIS-II/RUN, assign :WOR.K: to a write-enabled device with the 
RUN WORK command. 

If you are using ISIS-III/RUN, :WORK: is always assigned to :F9:. Therefore, assign 
:F9: to a write-enabled device/directory. 



C.6 Related Publications 

For more information on the Series III Microcomputer Development System, see the 
following manuals: 

• Intellect Series III Microcomputer Development System Overview, order number 

121575 

• Intellec® Series HI Microcomputer Development System Programmer's Refer- 
ence Manual, order number 121618 

• Intellec® Series 11 CRT and Keybtmrd Interface Manual, order number 122029 



C-2 



APPENDIX D 
USING AEDIT-86 ON THE SERIES IV 



AEDIT-86 runs on the iNDX operating system on the Intellec Series IV Microcom- 
puter Development System. 



D.1 Invocation Command 

The invocatioiL Um is as described in Chapter 4. 

If you are starting the tutorial in Chapter I, type the following: 



D.2 Keyboard 

The Series IV keyboard has soft keys. Therefore, all commands may be invoked either 
with the initial letter of the command or with the corresponding soft key. 

CHAR DELETE The CHAR DELETE (delete chs^p!j|tp|J|Dy|e^^^@ ^eac- 
ter "under" the cursor. 

CLEAR LINE The CLEAR LINE key deletes the entire, )pepQ which the cursor 
is positioned. 

Most keys have a built-in automatic repeat functjpn. To enter multiple characters, 
simply continue pr@mng the same ksy. file € HdME > and < ESC > keys do not 
repeat automatically. 




D.2.1 Soft Keys 

Eight function keys labeled FO F7 are located at the top of the keyboard. They corre- 
spond to the menu prompt line displayed on the bottom of the screen. These keys are 
called soft keys because their meaning changes depending on which menu prompt 
line is displayed. Pressing the soft key that corresponds to a menu selection displayed 
on the screen executes that command. Press the eighth soft key or < TAB > to display 
the next set of options. 

The function keys may be also used as single character macros under INSERT or 
XCHANGE mode. To define a macro associated with < PI > , for example, you 
should type — 

QCACROI pREATE) HlMIHHHl 

The hex code of < Fl > appears m tiie Screffl when the < Fl > key is pressed. The 
macro is ac^Med simply by pressing < Fl > while in INSERT af XCHANGE mode. 

Error, "illegal command?' is displayed if a soft key that has no corresponding option 
is pressed. This is because some prompt lines have fewer than ©ifht options; therefore, 
not all the soft keys are used. 
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D.3 Message Line 

The message line on the Series IV is 60 columns wide instead of 80. The last 20 
columns are reserved for the Series IV systena. 



D.4 Scrolling 

The Series IV has no reverse scrolling. Reverse scrolling is implemented as the VIEW 
command, and the screen is rewritten. 



D.5 Printing and Nonprinting Characters 

Except for the ESC, NUL, BELL, and backspace, all control characters are displayed 
on the screen as is and not as a question mark (?). 



D.6 Configuration Commands 

The hardware identification value AH is S4 for the Series IV. Configuration 
commands are presented in Table 9-2. 



D.7 Default Macro File 

If AEDIT-86 is not located in the current directory, you may have problems activat- 
ing the default macro file. 

The name of the default macro file is AEDIT.MAC, which is assumed to be in the 
current directory. If it is not, you must explicitly specify the MACRO( f//ename) 
control. 



D.8 Using Series IV with Remote Terminals 

When a remote terminal is connected to the Series IV, the configuration file is 
different. 

The communication program (STTY) takes care of most of the terminal specific 
input/output codes. The only items that must be in the configuration file are — 

• The terminal length (if not 25 lines) 

• Codes for < DELCH > and < DELLI > because they almost always differ from 
the Series IV CHAR DELETE and CLEAR LINE codes 

A sample configuration file for a terminal with 24 lines is — 

AH = 54; 
AV = 24; 

AFXF=06; AFXZ=1A; 

NOTE 

Do not use the regular configuration file for that terminal. For example, if 
you attach a Zentec terminal to your Series IV, use the configuration 
command given above and not ZENTEC.MAC. 
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D.9 Work File 

The predefined file :WORK: must be properly assigned when AEDIT-86 is invoked. 
Under Series IV, :WORK: is automatically assigned to your home directory when 
you log in on the system. If, for any reason, the assignment does not exist or must be 
modifled, :WORK: aiust be assigned to a write-enabled directory using the ASSIGN 
or the LNAME commands. 

D.10 Related Publications 

For more information on the Series IV Microcomputer Development System, see the 
following manuals: 

• Intellect Series IV Microcomputer Development S^Mem' &mrvievii, (wder number 
121752 

• Intellect S&ies IV Operating and Pr0p>mi^t^ Gufi^, <Mier attiti&«r 121753 

• Intelled* IV ISIS-IV User's Guide, order ainober 1 21 880 
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APPENDIX E 
USING AEDIT-86 ON THE 
iRMX '^-BASED SYSTEM 



AEDIT-86 runs on the iRMX operating system. 

The iRMX operating system may be used with various terminals. Please check the 
characteristics of your particular environment and/or terminal. 

E. 1 Invocation Command 

The invocation line is as described in Chapter 4. 

If you are starting the tutorial in Chapter 1, type th@ MomIe^: 



E.2 Special Considerations 

Note that under iRMX-86 releases 5 and 6, you must specify AT=F. 



E.3 Default Macro File 

If AEDIT-86 is not located in the current ^mdtmy,. ym m^h»mpe(Mwi& activat- 
ing the default macro file. 

The name of the default macro file is AEDIT.MAC, which is assumed to be in the 
oirrent directory. If it is not, you must explicitly specify the MACRO( ff/ename) 
control. 



The predefined file :WORK: must be properly assigned when AEDIT-86 is invoked. 
This assignment is usually done automatically when iRKS k bmoied. Ym must take 
care not to destroy :WORK:. 




E.4 WortcFiie 
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CONFIGURING AEDIT-86 
FOR QTHEB TERMINALS 



F.I Tested Configurations 



This appendix contains configurations for several other terminals. The terminals 

described here are not the only ones on which you can use AEDIT-86; they are merely 
the ones that have been tested. The following sections list the configuration functions 
and values required to run AEDIT-86 on the Intel-tested terminals. Configuration 
files for the following terminals are supplied with the AEDIT-86 program. The 



teitainals are listed alphabetically according to the macfOlHilMte: 

• 1510E.MAC — ^Hazeltine 1510 with es^ftefei^'lii 

• 151 OT.MAC— Hazeltine 1510 with tilde lead-in 

• ADM3A.Mi|C-^ar Seiglcr ADM-3A 

• MICROB.MAC— Beehive Mini-Bee 

• QVT102.MAC— QumeQVT102,terri'O2ffli8^ 

• S3.MAC — Series III with integrated Series III terminal 

• SMMAi'^-B^aM III with integrated HIE terminal 

• S3ET.MAC — Series HIE terminal used as terminal to remote host 

• S4.MAC— Sfedes IV terminal 

• TV91(H».M4tC—Televideo 910 Plus 

• TV925.MAC— Televideo 925 and 950 

• VIEW^iiW:— ADDS Viewpoint 3A Plus 

• VT 1 00. MAC— Digital Equipment Corporation VT 1 00, VT 1 1 , VT 1 02 

• VT52.MAC— Digital Equipment Corporatiem VTS2 

• ZENTEC.MAC — Zentec Zepher and Cobra 

t 

Most CRT terminals have switches to set certain screen or keyboard characteristics. 
These switches must be set as in Table F-1 for AEDIT-86 to function correctly. 
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Table F-1 . Switch Settings 



Switch 



BAUD RATE 

FULL DUPLEX 
RS232 

COMMUNICATION 
SELF ECHO 
PARITY 

PARITY SENSE 

BITS/CHAR 

STOP BITS 

SCROLLING 

EOM (End Of Message) 

AUTO LINE FEED 

or EOL CHAR 

or NEW LINE 

or RETURN 
DTR 

CHARS/LINES 
LINES/PAGE 



Setting 



Must match system. Use the maximum baud 

rate possible. 
ON 
ON 

CONVERSATIONAL 

OFF 

INHIBIT if available, ottierwise 

SPACE or (ZERO) 
EVEN or ODD (don't care) 

8 
1 

ON 

OFF 

OFF 

CR ONLY 
CR ONLY 
CR ONLY 
OFF 
80-255 
5-66 



Xon/Xoff protoco 


should be disabled, if available. 


XON/XOFF 


OFF 


Wraparound must correspond to the AW configuration command. 


WRAPAROUND 


ON if AW=T, or OFF if AW=F 


Unique to tfie Lear Seigler ADM3A 


SPACE/ADVANCE 

< CTRL-Z > CLEAR SCREEN 


SPACE (destructive space) 
ENABLE 


AEDIT- 


B6 don't care settings 



SCROLL TYPE 
25TH LINE 
CHARACTER SET 
CURSOR STYLE 
AUTOREPEAT 
MARGIN BELL 
KEYCLICK 

SCREEN BACKGROUND 
UPPERCASE ONLY or 
UPPER-/LOWERCASE 



JUMP or SMOOTH 



UNDERLINE, BLOCK, STEADY, BLINKING 



NORMAL, REVERSE 



1510E.MAC— Hazeltine'" 1510 



This terminal displays 24 lines of 80 characters per line. The characters are gener- 
ated in a 7X10 dot matrix. The maximum transmission rate is 19. 2K baud. You may 
choose between the ESC or the tilde (-) character as the control sequence lead-in. It 
is advisable to use the tilde; if you use the ESC, you must change the BREAK 
character. 
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Macro file: 1S10E.M AC - for the Hazeltine 151Q with escape lead-4n^ 

AV = 24; 

AFCU= OC; AFCD= OB; AFCR=10; AFCL = 8; AFCH= 12; 
AFMU=1B OC; AFMD=15 OB; AFMR=10; AFML=8; AFMH = 1B 12; 
AFES=; AFER=1B 18; APER==; AFEL=1B OF; 
AFDL=1B 13; AFIL=1B lA; 
AFAC=1B 11; AO = 0; AX = T; 

AFRV=1B IF; AFNV=1B 19; AC = T; Al=t| ,i •• 
ADDL=20; ADIL=20; \ * 19200 baud * \ 

AB=71; AFIG=1B; 
AFXH=16; 

Notes: Tilde is used for < ESC > . 

< CTRL-V > is used for < HEX > . 



1S1QT.MAC— Hazeltine™ 1510 

Macro file: 1510T.MAC for Hazeililie 1510 Wi^ tilde lead-in. 



AV = 24; 

AFCU= OC; AFCD= OB; AFCR=10; AFCL = 8; AFCH= 12; 

AFMU = 7E OC; AFMD = 7E OB; AFMR= 10; AFML=8; AFMH=7E 12; 

AFES=; AFER=7E 18; AFEK=; AFEL=7E OF; 

AFDL = 7E 13; AF1L = 7E lA; 

AFAC = 7E 1 1; AO = 0; AX = T; 

AFRV = 7E IF; AFNV = 7E 19; AC = T; A1=T; 

ADDL=20; APXL,=20; \ * 19200 bmi * \ 

AF1G = 7E; 
AFXH=16; 

Notes: cCfltlLpV* is used for <HEX>. 



ADM3A.MAC— Lear Siegler™ ADM3A 

This terminal displays 24 lin^ ei 80 characters per line. The characters are gener- 
ated in a 5X7 dot matrix. The maitimum transmission rate is 19.2K ttattlt. 

Macro file: ADM3A.MAC for the Lear Siegler ADM3A. 

AV = 24; 

AFCU = OB; AFCD = OA; AFCR = OC; AFCL=08; AFCH=1E; 
AFMU = OB; AFMD = OA; AFMR = OC; AFML=^a§; AFMH^ IE; 
AFES = 1 A; AFER = ; AFEK = ; AFEL = ; 
AFAC=1B 3D; AO =20; AX=F; 
ADES=5; \ * 19200 baud * \ 

AFXH=16; 

Notes: < CTRL-V > is used for < HEX > . " ' ' 



Switch 



Setting 

SPACE 
ENABLE 



SPACE/ AD VANCE 
<CTRL-Z> CLEAR SCREEN 
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MICROB.MAC— Beehive* Miitl'«ee 

This Beehive terminal can be formatted to display either 1 2 or 25 lines of 80 charac- 
ters per line. Only the 25-character format is usable with AEDIT-86. Each character 
is generated in a 5X7 dot matrix. The maximum transmission rate for this terminal 
is 9600 baud. Note that the ESCAPE character has to be changed so that the default 
ESCAPE code can be used; < CTRL-K > is typed instead of escape. 

Macro file: MICROB.MAC for the Beehive Mini-Bee. 

AV=24; 

AFCU=1B 41; AFCD=1B 42; AFCR=1B 43; AFCL=1B 44; AFCH = 1B 48; 
AFMU= IB 41; AFMD= IB 42; AFMR= IB 43; AFML= IB 44; AFMH= IB 48; 
AFES=; AFER=1B 4A; AFEK=; AFEL=1B 4B; 

AB=OB; 

Notes: < CTRL-K > is used for < ESC > 
QVT102.MAC— Qume" QVTI^ 

This terminal displays 24 lines with 80 characters per line. The maximum transmis- 
sion rate is 19.2 K baud. 

Macro file QVT102.MAC for the Qumc QVT102 in VT102 mode. 

AV=24; 

AFCU = OB; AFCD = OA; AFCR=OC; AFCL = 08; AFCH=1E; 
AFMU = OB; AFMD=0A; AFMR = OC; AFML=08; AFMH=1E; 
AFES=1B 2B; AFER=1B 59; AFEK=; AFEL=1B 54; 
AFDL=1B 52; AFIL=1B 45; 
AFAC=1B 3D; AO = 20; AX = F; 
ADIL= 140; \ * 19200 BAUD * \ 

AFXH=16; 

Notes:: < CTRL-V > is used for < HEX > . 

S3.MAC— Series ill with Integrated Series Hi Tmmlmit 

Macro file: S3.MAC for the Series III with the integrated Series III terminal. 

AH=S3; 

S3E.MAC— Series HI wIBi bitegrated Series IIIE T«rminal 

Macro file: S3E.MAC for the Series III with the integrated Series IIIE terminal. 
AH=S3E; 

S%T.iNAC— Series III as Temrinal to Remcrte Host 

Macro file: S3ET.MAC for the integrated Series IIIE terminal when used as termi- 
nal to a remote host. 

AH=S3ET; 
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for Other Terminals 



S4.IIIAC— SMilvflP^Ternndii^ 

Macro file: S4.MAC for the Series IV terminal. 



TV910P.MAC— T^video™ 910 Pius 



This terminal displays 24 lines with 80 characters per line. The maximum transmis- 
sion rate is 19.2K baud. 



Macro file: TV910P.MAC for the Televideo 910 Plus. 



AV=24; 

AFCU = OB; AFCD=16; AFCR = OC; AFCL = 08; AFCH=1E; 
AFMU = OB; AFMD= 16; AFMR = OC; AFML = 08; AFMH=1E; 
AFES = 1 B 2B; AFER = 1 B 59; AFEK=; AF®;w4B Ji^ 
AFDL=1B 52; AFIL=1B 45; 
AFAC=1B 3D; AO=2(^ AX-F; 
ADIL=20; \ * 19200 BAUD * \ 



AFXH=16; 

Notes: < CH^V » is used for < HEX > . 



TV925 JIAC— TeiQvideo'" 92S and 950 



This terminal displays 24 lines with 80 characters per line. The maximum transmis- 
sion rate is ItiJK l^ud. 



Macro file: TV925.MAC for the Televideo 925 and. 950. 
AV=24; 

AFCU=OB; AFCD=OA; AFCR = OC; AFCL=08; AFCH = 1E; 
AFMU=OB; AFMD=0A; AFMR=OC; AFML=08; AFMH=1E; 
AFES = IB 2B; AFER = IB 59; AFEK**; Afa^^llM; 
AFDL= IB 52; AFIL= IB 45; 
AFAC=1B 3D; AO =20; AX=F; 

\ * AFRV= IB 47 34; AFNV= IB 47 30; AC=F; AI=F; * \ 
ADIL=60; \ * 19200 baud * \ 

AFXH=16; 

Notes: < CTRL-V > is used for < HEX > 



VIEW3A.MAC— ADDS"* Viewpoint 3A Plus 

This terminal displays 24 lines with 80 chara«i|^|tpr Use. 
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Macro file: VIEW3A.MAC for ADDS Viewpoint 3A Plus, in 3A plus mode. 

AV = 24; 

AFCU=OB; AFCD = OA; AFCR = OC; AFCL = 08; AFCH=IE; 
AFMU = OB; AFMD = OA; AFMR=OC; AFML = 08; AFMH=1E; 
AFES= IB 2A; AFER = IB 59; AFEK = ; AFEL=1B 54; 
AFAC=1B 3D; AO =20; AX=F; 

AFXH=16; 

Notes: <CTRL-V> is used for < HEX > . 

Switch Setting 

< CTRL-Z > CLEAR SCREEN ENABLE 

VT100.MAC— DEC VT100 

This terminal can be formatted with 14 lines of 132 characters per line or 24 lines of 
80 characters per line. Only the 24-line format is compatible with AEDIT-86. The 
characters are generated in a 7X9 dot matrix. The maximum transmission rate is 
19.2K baud. You may choose between the DEC VT52 compatible and the ANSI 
standard (X3.41-1974, X3.64-1977) compatible terminal escape sequences for cursor 
control and screen erase functions. See the DEC VT52 description for the VT52 codes. 
Note that the ESCAPE character has to be changed so that the default ESCAPE 
code can be used; PF4 is typed instead of escape. This terminal does not have a 
HOME key: PFl is typed instead of home. 

Macro file: VTIOO.MAC for the Digital Equipment Corporation VTIOO, VTlOl, 
VT102. 

Configuration commands for the VTIOO are given in Tablte 9-1. 
AH = VTIOO; 

Notes: PF4 is set as escape. 
PFl is set as home. 
Wraparound must be turned off. 

Do not use baud rates above 9600. 
Automatic XON/XOFF must be turned off. 

The delete/insert line output function codes, although available on VTIOO 
and VT 1 02, are not used because of poor performance. 

VT52.iyiAC— DEC™ VT52 

This terminal displays 24 lines of 80 characters per line. The characters are gener- 
ated in a 7X9 dot matrix. The maximum transmission rate is 19.2K baud. Note that 
the ESCAPE character has to be changed so that the default ESCAPE code can be 
used; < CTRL-K > is typed instead of escape. This terminal does not have a HOME 
key; < CTRL-O > is typed instead of home. 

Macro file: VT52.MAC for the Digital Equipment Corporation VT52. 
AV = 24; AW = F; 

AFCU= IB 41; AFCD= 1 B 42; AFCR= 1 B 43; AFCL= 1 B 44; AFCH = OF; 
AFMU=1B 41; AFMD=1B42; AFMR=1B 43; AFML=1B 44; AFMH=1B48; 
AFES = ; AFER=1B 4A; AFEK=; AFEL=1B4B; 
AFDL = ; AFIL=1B 49; 
AFAC=1B 59; AO=20; AX = F; 

AB=OB; 

Notes: < CTRL-K > is used for < ESC > . 

< CTRL-O > is used for <HOME>. 
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ZENTEC.MAC — Zentec"" Zepher and Gdira 

This terminal displays 24 lines of 80 characters per line. The maximum transmission 
rate is 19.2K baud. To rub out a character on this temwal ym most use SHIFT 

plus ESC. 

Macro file: ZENTEC.MAC for the Zentec Zepher and Cobra. 

AV = 24; 

AFCU = OB; AFCD = OA; AFCR = OC: AFCL = 08; AFCH=1E; 

AFMU = OB; AFMD = OA; AFMR = OC; AFML = 08; AFMH=1E; 

AFES=1B 23; AFER=1B 59; AFEK=OD IB 54; AFEL=1B 54; 

AFDL=1B 52; AFIL=1B45; 

AFAC=1B 3D; AO = 20: AX = F; 

AFRV=1B 47 34; AFNV=IB 47 30; AC = F; AI = F; 

ADIL=60; \ * lf2« baud * \ 

AFXH = 16; 

Notes; The DEL key (shift ESC) is used for < RUBOUT > . 
< CTRI^V > is used for < HEX > . 
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J^ll CODES 



ASCII 
Character 




ASCII 
Character 




NUL 


(t@) 




(Hi 


An 

•TV 


SOH 


(tA) 


U 1 


A 

M 


•r 1 


STX 


(tB) 




a 

D 


AS 


ETX 


(tC) 


uo 






EOT 


(tD) 




n 

\J 


ilil 
•t^t 


ENQ 


(tE) 


(\K 
UD 


p 




ACK 


(tF) 


OA 


F 

r 


■to 


BEL 


(tG) 






■1/ 


BS 


(tH) 


uo 


u 

n 


•fO 


HT 


(tl) 


(jy 


1 
1 


itO 

48 


LF 


(t J) 


UA 


1 

J 


4A 


VT 


(tK) 


Ud 


l/C 
l\ 


mo 


FF 


(tL) 




L 


4C 


CR 


(tM) 


fin 


M 




SO 


(tN) 




N 


4e 


SI 


(tO) 


OF 





m 


DLE 


(tP) 


10 


P 


m 


DC! 


(tQ) 


11 


Q 


SI 


DC2 


(tR) 


12 


R 


52 


DC3 


(tS) 


13 


S 


S3 


DC4 


(TT) 


14 


T 


S4 


NAK 


(tU) 


15 


U 


ss 


SYN 


(t V) 


16 


V 


S6 


ETB 


(t W) 


17 


w 


57 


CAN 


(tX) 


18 


X 


58 


EM 


(tY) 


19 


Y 


59 


SUB 


(tZ) 


1A 


z 


5A 


ESC 


1 Q 
lt> 


r 
[ 


CD 


FS 




1/^ 
1W 






GS 






1 

i 


en 






1 e 


A f 


B£ 

ae: 


us 




1 r 




or 


space 


on 


« 




I 




Oi 




isi 






oo 


D 


BSC 


# 




OQ 
£0 


C 


RO 
tK> 


$ 




Oil 


Q 


Ail 


%. 




OR 


6 


ISA 


a 




cD 


T 


DO 






C.I 


9 


Air 
8/ 


( 
) 




ttk 
Zo 


n 


AO 




9Q 

49 


i 








OA 


j 


AA 
OA 


4- 




2@ 


K 


AO 
OB 


r 






1 
1 


A/^ 






2U 


m 


en 

oD 






2E 


n 


BE 


/ 




2F 


o 


6F 







30 


P 


70 


1 




31 


q 


71 


2 




32 


r 


72 


3 




33 


s 


73 


4 




34 


t 


74 


5 




35 


u 


75 


6 




36 


V 


76 


7 




37 


w 


77 


8 




38 


X 


78 


9 




39 


y 


79 






3A 


z 


7A 


I 




3B 


{ 


7B 


< 




3C 


1 


7C 






3D 


> 


7D 


> 




3E 




7E 


7 




3F 


DEL 


7F 



NOTE: Control key equivalences are in parentheses. 
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-FIND command (-), 3-9 
-??- busy/waiting indicator, 1-2, 2-5 
" in macro commands, 5-3, 5-8 
! lines and line terminators, 2-6 
/ repeat function, 2-7 
/ in INSERT mode, 3-6 
@ in BLOCK command, 1-4, 3-13 
? printing and non-printing characters, 2-6, 3-19 
7REPLACE command {?), 3-10—3-11 
< > angle brackets, A-1 

Abort (QUIT subcommand), 3-24 

ADDS Viewpoint 3A Plus terminal, F-5— F-6 

AGAIN command (A), 3-16 

algebraic shift operator, 7-4 

arrow keys, see cursor movement commands 
Autonl (SET subcommand), 3-17 

backslash in macros, 5-3, 5-8 
Bak_file (SET subcommand), 3-17 
BATCH control (BA), 4-9—4-1 1 
Beehive Mini-Bee terminal, F-4 
ta^iiraming, 2-6 
binary opetator, 7-4 
Block buffer, 2-7, 3-13 
BLOCK command (B), 3-12—3-14 

Buffer, 3-13 

Delete, 3-14 

Find, 3-14 

-find, 3-14 

Jump, 3-14 

Put* 3-14 
MFir, 2-7 

Block, 2-7, 3-13 

current, 2-7 

main, 2-7 

OTHER, 2-7, 3-15 

secondary, 2-7 
Buffer (BLOCK subcommand), 3-13 
busy/ waiting indicator, 1-2, 2-5 

CALC command (C), 7-1—7-6 
carriage return, see RETURN key 
Case (SET command), 3-11 

A^AIN, 3-16 

BLOCK, 3-12—3-14 

CALC, 7-1—7-6 

cursor movements, 3-1 — 3-3 

EXECUTE, 5-5—5-6 

FIND, 3-8—3-9 

-FIND, 3-9 

GET, 3-15 



HEX, 3-23—3-26 

INSERT, 3-5—^ 

JUMP, 3-11—3-12 

MACRO, 5-1—5-4 

OTHER, 3-15—3-16 

QUIT, 3-24—3-26 

REPLACE, 3^—M§ 

7REPLACE, 3-10—3-11 

SET, 3-16—3-22 

TAG, 3-11 

UNDO, 3-4—3-5 

VIEW, 3-15 

XCHANGE, 3-6—3-7 
configuring AEDIT-86 for other terminals, F-1- 
configuration commands, 9~l — 9-4 
configuration values, 9-4—9-6 
copying text, 1-4, see also BLOCK command 
count, 2-7 

Create (MACRO subconnutnand), 5-1—5-2 

< CTRL > key, 2-1 

< CTRL-A > , 3-4 

3-3 
3-4 
3-5 

6-1^64 
6-2—6-3 
3-4 

3-4 
3-4 



-F-7 



< CTRL-C > 

< CTRL-F > 

< CTRL-H > 

< CTRL-N > 

< CTRL-S > 

< CTRL-U > 

< CTRL-X > 

< CTRL-Z > 
current buffer, 2-7, 3-15 
current file, 3-24 
cursor, 1-2, 2-2 

cursor movement commands, 3-1 — 3-3 

< DOWN > , 3-2 

< HOME > , 3-2 
<LEFT>, 3-1 

< RIGHT > , 3-1 
<UP>,3-2 



delay codes, 9-6 

DEC VT52 terminal, F-6 

DEC VTIOO terminal, F-6 

Delete (BLOCK subcommand), 3-14 

DELETE command (D), 3-14 

delete function keys, 3-3 — 3-4 

< DELCH > command ( < CTRL-F > ), 3-4 

< DELLl > command ( < CTRL-Z > ), 3-4 

< DELL > command ( < CTRL-X > ), 3-4 
<DELR> comnraad (« CTRL-A >), 3-4 

< RUBOUT > , 3-3 
deleting macros, 5-4 

deleting text, 1-2 — 1-4, see also BLOCK command 
delimiter set, 3-18 
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Display, 2-2 

Display (SET subcommand), 3-18 
DOWN command, 3-2 

E_delimit (SET subcommand), 3-18 
End (JUMP subcommand), 3-12 
ending ap editing session, 1-5, 3-24 — 3-26 
End-Of-File (EOF) marker, 1-2, 2-2 
error messages, B-1 — B-4 
ESC key, 2-1 
exchanging text, 3-6 — 3-7 
EXECUTE command (E) 5-5—5-6 
Exit (QUIT command), 3-25 

< FETN > , 6-1—6-2 

< FETS > , 6-2—6-3 
file backup, 3-17 

Fill (PARAGRAPH subcommand), 3-26 

FIND command (F), 3-8—3-9 

Find (BLOCK subcommand), 3-14 

-FIND command (-), 3-9 

-And (BLOCK subcommand), 3-14 

FORWAjRDONLY control (FO), 4-4 

function key, 2-1 — 2-2, A-1 — ^A-2 

GET Command (G), 3-15 

Get (MACRO subcommand), 5-2—5-3 

global vmables, 6-1 

Go (SET subcommand), 3-19 

Hazeltin^ 1510 terminal, F-2— F-3 
HEX command (H), 3-23—3-24 

Input, 3-23 

Output, 3-23 
HEX examples, 3-24 

< HEX > function key, 2-5, 3-5 
Highbit (SET subcommand), 3-19 
HOME key, 2-1, 3-2 

Indent (SET subcommand), 3-19 

Init (QUIT subconmiand), 3-25 

Input (HEX subcommand), 3-23 

Insert (MACRO subcommand), 5-3 — 5-4 

INSERT mode (1), 3-5—3-6 

inserting text, 1-2 — 1-4, 3-5 — 3-6 

invocatioii command, 1-2, 4-1—4-2, C-1, D-1, E-1 

invocation controls, 4- — 4-10 

BATCH, 4-9—4-10 

FORWARDONLY (FO), 4-4 

MACRO (MR), 4-7 

MACRbsiZE (MS), 4-8 

RECOVER (RC), 4-6 

VIEWONLY (VO), 4-5 

JUMP command (J), 3-12 
Start, 3^12 

End, 3-12 
Line, 3-12 
Position, 3-12 
Tags A-D, 3-12 



Jump (BLOCK subcommand), 3-14 
Justify (PARAGRAPH subcommand), 3-27 

K_token (SET subcommand), 3-20 
keyboard, 2-1 — 2-2 
KILLWND comnMnd (K), 3-27 

Lear Sicgler ADM-3A terminal, F-3 
Leftcol (SET subcommand), 3-20 
LEFT command, 3-1 
Line (JUMP subcommand), 3-12 
line-edited prompt, 2-4 — 2-5 
List (MACRO subcommand), 5-2 
local variables, 6-3 

MACRO command (M), 5-1—5-4 

Create, 5-1—5-2 

Get, 5-2—5-3 

Insert, 5-3 — 5-4 

List, 5-4 

Save, 5-4 
MACRO control (MR), 4-7 
macro control codes, 5-8 
macro, deleting, 5-4 
macro definitions, 5-1 
macro examples, 5-10 — 5-12 
macro failure, 5-8 
macro files, 5-7 
macro modes 

modeless, 5-5 

non-modeless, 5-5 
macro, single-character, 5-6 
MACROSIZE control (MS), 4-8 
main buffer, 2-7 
main command level, 1-2 
Margin (SET subcommand), 3-20 
menu prompt, 2-3 — 2-4 
message line, 2-5 
< MEXEC > , 5-7 
mode, 1-2 

INSERT, 3-5—3-6 

XCHANGE, 3-6—3-7 
moving text. See BLOCK command 

Notab (SET subcommand), 3-21 
numeric constant, 7-3 
N-variables, 6-1 

operators 

algebraic shift, 7-4 

binary, 7-4 

shift/rotate, 7-4 

unary, 7-4 
OTHER buffer, 2-7, 3-15 
OTHER command (O), 1-5, 3-15—3-16 
Output (HEX subcommand), 3-23 



PARAGRAPH command (P), 3-26- 
Fill, 3-26 
Justify, 3-27 
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Position (JUMP subcommand), 3-12 
printing and non-printing characters, 2-6, D-2 
prompt line, 2-3 — 2-5 
prompts, 

menu prompts, 2-3 — 2-4 

line-edited prompts, 2-4 — '3-$ 

y^m prompts, 2-S 
T»Bt <m-OCK subcommand), 3-14 

QUIT command (Q), 3-24—3-26 

Abort, 3-24 

Exit, 3-25 

Init, 3-25 

Update, 3-25 

Write, 3-25 
C^mm^yriOl terminals, F-4 

Radix (SET subcommand), 3-32, 6-1 
read-only variables, 6-2 
read-write variables, 6-1 — 6-2 
RECX)VER control (RC), 44 
reedit mode, 2-4 
repeat function (count), 2-7 
REPLACE command (R), 3-9—3-10 
7REPLACE command(?), 3-10—3-11 
FSraiN key, 2-t, M 
RlCrHT command, 3-1 
< RUW)UT > key, 2-2, 3-3 
RUN command, C-1 

Sums (MACRO subcommand), 5-4 
scr^-mode editing, 2-2 
secondary buffer, 2-7, 3-15 
secondary file, 3-24 
Smes III terminal, C-1, F-4 

HIE terminal, €4, 
Smes IV, D-l— D-3, F-5 
SET (S) command, 3-16— 3»22 

Autonl, 3-17 

BakJUe, 3-17 

Case, 3-8, 3-17 

Display, 3-18 

E_delimit, 3-18 

Highbit, 3-19 

Indent, 3-19 

K_token, 3-8, 3-20 

Leftcol, 3-20 

Margin, 3-20 

Notab, 3-21 

Radix, 3-21, 6-1 

Sbowfind, 3-8, 3-21 

Tabs, 3-22 

Viewrow, 3-22 
SET commands in macro fifm, 1-7 
8creen-mode editing, 2-2 



shift/rotate operator, 7-4 

Showfind (SET subc<|mmand), 3-8, 3-21 

singJe-<Aaittcter macro, 5-6 

soft keys, D-l 

Start (JUMP subcommand), 3-12 
starting an editing session, 1-2, 4-1 — 4-3 
string constant, 7-3 
string variables, 6-2 

subcommands, 1-2 

summary of commands, A-1 — A-6 

summary of variables, 6-5 

S-variabies, 6-2 

syntax diagram, 7-1 — 7-2 

TAB key, 2-2, 3-3 
"Bsbs (SET subcommand), 3-22 
Tags (JUMP subcommand), 2-6, 3-12 
TAG command (T), 3-1 1 

Televideo 910 Plus terminal, F-5 
Televideo 925 and 950 terminal, F-5 

axtA, 24 
token, 3-20 
tutorial, 1-1 — 1-5 

unary operator, 7-4 

UNDO eoieiffiaad ( < CTRL-U > ), 3-4 
UP command, 3-1 
Update (QUIT subcommand), 3-25 
USEFUL.MAC, 8-1—8-3 

variables 

AEDIT-86, 5-6, 6-1—6-7 

global, 6-1 

local, 6-3 

numeric, 6-1 

read-only, 6-2 

read-write, 6-2 

N-variables, 6-1 

string, 6-2 

summary,6-5 

S-variables, 6-2 
VIEW command (V), 3-15 
VIEWONLY control (VO), 4-5 
Viewrow (SET subconmiand), 3-22 

WINDOW COTttBiand (W), 3-27 

workfiles, 4-11, C-2, D-3, E-1 
Write (QUIT subcommand), 3-25 

XCHANGE mode (X), 3-6—3-7 

yes/no prompts, 2-5 

Zentec Cobra and Zephyr terminal, F-7 
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